GetPersistentData

返回由名称和实例 ID 指定的持久化数据值。

格式 

GetPersistentData ( 名称 ; 实例 ID )

参数 

名称 - 指定持久化数据条目名称的文本表达式。

实例 ID - 标识条目特定实例的文本表达式。必须与存储数据时使用的实例 ID 相匹配。可以是空字符串 ("")。

返回的数据类型 

文本、数值、日期、时间、时间戳、容器

原始版本 

26.0

说明 

该函数按名称和实例 ID 从持久数据存储中检索值。返回值的数据类型与存储的数据类型相匹配。请参阅关于持久化数据存储。

如果没有指定名称和实例 ID 的条目，此函数将返回“?”。

注释 

  • 使用 ListPersistentDataIDs函数查找给定名称的所有实例 ID。

  • 如果您将实例 ID 指定为空字符串 ("")，该函数将寻找具有空实例 ID 的条目。

示例 1 

如果AppVersion没有设置的实例 ID，比如配置持久化数据脚本步骤中的示例 1，GetPersistentData ( "AppVersion" ; "" ) 返回 2.1.1.0。

示例 2 

未找到指定条目时，返回指定条目或空 JSON 对象作为默认值。

复制 
Let (
  config = GetPersistentData ( "com.claris.myaddon.settings" ; "38EA3124-9CFD-4490-A634-A0A72A613145" ) ;
  If ( config = "?" ; JSONSetElement ( "" ; "" ; "" ; JSONObject ) ; config )
)

示例 3 

设置网页查看器的 URL 时，从持久数据存储中检索 JavaScript 库。这种方法将大型 JavaScript 代码排除在您的计算公式之外，并使其更容易更新。

复制 
设置 Web 查看器 [ 对象名称: "webviewer" ; URL: 
  "data:text/html," &
  "<html><head><script>" &
  GetPersistentData ( "ChartLibrary" ; "SharedLibraries" ) &
  "</script></head>" &
  "<body><div id='chart'></div>" &
  "</body></html>" 
]

相关主题