Class DataSourceFormula

DataSourceFormula

访问和修改现有数据源公式。若要创建新的数据源公式，请使用 Range.setFormula(formula)。

此类仅适用于连接到数据库的数据。

方法

方法返回类型简介
cancelDataRefresh()DataSourceFormula取消与此对象关联的数据刷新（如果它当前正在运行）。
forceRefreshData()DataSourceFormula刷新此对象的数据，而不考虑当前状态。
getAnchorCell()Range返回 Range，它表示此数据源公式锚定到的单元格。
getDataSource()DataSource获取对象链接到的数据源。
getDisplayValue()String返回数据源公式的显示值。
getFormula()String返回此数据源公式的公式。
getStatus()DataExecutionStatus获取对象的数据执行状态。
refreshData()DataSourceFormula刷新对象的数据。
setFormula(formula)DataSourceFormula更新公式。
waitForCompletion(timeoutInSeconds)DataExecutionStatus等待当前执行完成，在提供的秒数后超时。

详细文档

cancelDataRefresh()

取消与此对象关联的数据刷新（如果它目前正在运行）。

以下示例展示了如何取消公式刷新。 

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

如果数据源类型未启用，则会抛出异常。使用 SpreadsheetApp#enable...Execution() 方法可针对特定数据源类型启用数据执行。

弃踢回攻

DataSourceFormula - 数据对象。

授权

使用此方法的脚本需要以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forceRefreshData()

刷新此对象的数据，而不考虑当前状态。如需了解详情，请参阅 refreshData()。若要取消此对象当前正在运行的刷新，请参阅 cancelDataRefresh()。

如果数据源类型未启用，则会抛出异常。使用 SpreadsheetApp#enable...Execution() 方法可针对特定数据源类型启用数据执行。

弃踢回攻

DataSourceFormula - 数据对象。

授权

使用此方法的脚本需要以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAnchorCell()

返回 Range，它表示此数据源公式锚定到的单元格。

弃踢回攻

Range - 锚定单元格。

授权

使用此方法的脚本需要以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDataSource()

获取对象链接到的数据源。

弃踢回攻

DataSource - 数据源。

授权

使用此方法的脚本需要以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDisplayValue()

返回数据源公式的显示值。

弃踢回攻

String - 显示值。

授权

使用此方法的脚本需要以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFormula()

返回此数据源公式的公式。

弃踢回攻

String - 公式。

授权

使用此方法的脚本需要以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getStatus()

获取对象的数据执行状态。

弃踢回攻

DataExecutionStatus - 数据执行状态。

授权

使用此方法的脚本需要以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

refreshData()

刷新对象的数据。

如果当前处于 error 状态，则会抛出异常。使用 DataSource#updateSpec() 更新规范。此方法优于 forceRefreshData()，可防止对数据源进行意外修改。

如果数据源类型未启用，则会抛出异常。使用 SpreadsheetApp#enable...Execution() 方法可针对特定数据源类型启用数据执行。

弃踢回攻

DataSourceFormula - 数据对象。

授权

使用此方法的脚本需要以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFormula(formula)

更新公式。

参数

名称类型说明
formulaString新公式。

弃踢回攻

DataSourceFormula - 数据源公式，用于串联。

授权

使用此方法的脚本需要以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

waitForCompletion(timeoutInSeconds)

等待当前执行完成，在提供的秒数后超时。 如果超时执行时未完成，但未取消数据执行，则会抛出异常。

参数

名称类型说明
timeoutInSecondsInteger等待数据执行的时间，以秒为单位。最大值为 300 秒。

弃踢回攻

DataExecutionStatus - 数据执行状态。

授权

使用此方法的脚本需要以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets