未验证 提交 84ce10c6 编写于 作者: L liminjie10 提交者: Gitee

update zh-cn/application-dev/reference/apis/js-apis-settings.md.

Signed-off-by: Nliminjie10 <liminjie10@huawei.com>
上级 f38da453
...@@ -372,10 +372,12 @@ let urivar = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); ...@@ -372,10 +372,12 @@ let urivar = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
getValue(context: Context, name: string, callback: AsyncCallback\<string>): void getValue(context: Context, name: string, callback: AsyncCallback\<string>): void
stage模型使用。获取数据库中指定数据项的值。使用callback异步回调。 获取数据库中指定数据项的值。使用callback异步回调。
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在Stage模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -400,10 +402,12 @@ settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, (err, ...@@ -400,10 +402,12 @@ settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, (err,
getValue(context: Context, name: string): Promise\<string> getValue(context: Context, name: string): Promise\<string>
stage模型使用。获取数据库中指定数据项的值。使用Promise异步回调。 获取数据库中指定数据项的值。使用Promise异步回调。
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在Stage模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -430,10 +434,12 @@ settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS) ...@@ -430,10 +434,12 @@ settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS)
getValueSync(context: Context, name: string, defValue: string): string getValueSync(context: Context, name: string, defValue: string): string
stage模型使用。获取数据项的值。此方法相较getValue为同步方法。 获取数据项的值。此方法相较getValue为同步方法。
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在Stage模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -459,12 +465,14 @@ let value = settings.getValueSync(this.context, settings.display.SCREEN_BRIGHTNE ...@@ -459,12 +465,14 @@ let value = settings.getValueSync(this.context, settings.display.SCREEN_BRIGHTNE
setValue(context: Context, name: string, value: string, callback: AsyncCallback\<boolean>): void setValue(context: Context, name: string, value: string, callback: AsyncCallback\<boolean>): void
stage模型使用。将数据项名称及数据项的值保存到数据库中。使用callback异步回调。 将数据项名称及数据项的值保存到数据库中。使用callback异步回调。
**需要权限**:ohos.permission.MANAGE_SECURE_SETTINGS,仅系统应用可用。 **需要权限**:ohos.permission.MANAGE_SECURE_SETTINGS,仅系统应用可用。
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在Stage模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -486,12 +494,14 @@ settings.setValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100' ...@@ -486,12 +494,14 @@ settings.setValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100'
setValue(context: Context, name: string, value: string): Promise\<boolean> setValue(context: Context, name: string, value: string): Promise\<boolean>
stage模型使用。将数据项名称及数据项的值保存到数据库中。使用Promise异步回调。 将数据项名称及数据项的值保存到数据库中。使用Promise异步回调。
**需要权限**:ohos.permission.MANAGE_SECURE_SETTINGS,仅系统应用可用。 **需要权限**:ohos.permission.MANAGE_SECURE_SETTINGS,仅系统应用可用。
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在Stage模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -518,7 +528,7 @@ settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then ...@@ -518,7 +528,7 @@ settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then
setValueSync(context: Context, name: string, value: string): boolean setValueSync(context: Context, name: string, value: string): boolean
stage模型使用。设置数据项的值。此方法相较setValue为同步方法。 设置数据项的值。此方法相较setValue为同步方法。
如果数据库中已经存在该数据项,则setValueSync方法将更新该数据项的值;如果数据库中尚未存在该数据项,则setValueSync方法将向数据库中插入该数据项。 如果数据库中已经存在该数据项,则setValueSync方法将更新该数据项的值;如果数据库中尚未存在该数据项,则setValueSync方法将向数据库中插入该数据项。
...@@ -526,6 +536,8 @@ stage模型使用。设置数据项的值。此方法相较setValue为同步方 ...@@ -526,6 +536,8 @@ stage模型使用。设置数据项的值。此方法相较setValue为同步方
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在Stage模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -547,9 +559,9 @@ stage模型使用。设置数据项的值。此方法相较setValue为同步方 ...@@ -547,9 +559,9 @@ stage模型使用。设置数据项的值。此方法相较setValue为同步方
let ret = settings.setValueSync(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100'); let ret = settings.setValueSync(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100');
``` ```
## setting.getValue<sup>deprecated</sup> ## setting.getValue<sup>(deprecated)</sup>
> 从API version 9开始不再维护,建议使用stage模型的对应接口 > 从API version 7开始支持,从API version 9开始废弃,推荐使用[getValue()](#settinggetvalue9)
getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCallback\<string>): void getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCallback\<string>): void
...@@ -557,6 +569,8 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCall ...@@ -557,6 +569,8 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCall
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在FA模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -581,9 +595,9 @@ settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, (err, value ...@@ -581,9 +595,9 @@ settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, (err, value
}); });
``` ```
## setting.getValue<sup>deprecated</sup> ## setting.getValue<sup>(deprecated)</sup>
> 从API version 9开始不再维护,建议使用stage模型的对应接口 > 从API version 7开始支持,从API version 9开始废弃,推荐使用[getValue()](#settinggetvalue9-1)
getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\<string> getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\<string>
...@@ -591,6 +605,8 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\<string> ...@@ -591,6 +605,8 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\<string>
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在FA模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -616,9 +632,9 @@ settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS).then((value ...@@ -616,9 +632,9 @@ settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS).then((value
}); });
``` ```
## settings.setValue<sup>deprecated</sup> ## settings.setValue<sup>(deprecated)</sup>
> 从API version 9开始不再维护,建议使用stage模型的对应接口 > 从API version 7开始支持,从API version 9开始废弃,推荐使用[setValue()](#settingssetvalue9)
setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string, callback: AsyncCallback\<boolean>): void setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string, callback: AsyncCallback\<boolean>): void
...@@ -628,6 +644,8 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string, call ...@@ -628,6 +644,8 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string, call
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在FA模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -650,9 +668,9 @@ settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (res ...@@ -650,9 +668,9 @@ settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (res
}); });
``` ```
## settings.setValue<sup>deprecated</sup> ## settings.setValue<sup>(deprecated)</sup>
> 从API version 9开始不再维护,建议使用stage模型的对应接口 > 从API version 7开始支持,从API version 9开始废弃,推荐使用[setValue()](#settingssetvalue9-1)
setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): Promise\<boolean> setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): Promise\<boolean>
...@@ -662,6 +680,8 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): Pro ...@@ -662,6 +680,8 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): Pro
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在FA模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -689,9 +709,9 @@ settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then ...@@ -689,9 +709,9 @@ settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then
}); });
``` ```
## settings.getValueSync<sup>8+</sup> <sup>deprecated</sup> ## settings.getValueSync<sup>(deprecated)</sup>
> 从API version 9开始不再维护,建议使用stage模型的对应接口 > 从API version 8开始支持,从API version 9开始废弃,推荐使用[getValueSync()](#settingsgetvaluesync9)
getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: string): string getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: string): string
...@@ -699,6 +719,8 @@ getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: strin ...@@ -699,6 +719,8 @@ getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: strin
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在FA模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -724,9 +746,9 @@ let helper = featureAbility.acquireDataAbilityHelper(uri); ...@@ -724,9 +746,9 @@ let helper = featureAbility.acquireDataAbilityHelper(uri);
let value = settings.getValueSync(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '10'); let value = settings.getValueSync(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '10');
``` ```
## settings.setValueSync<sup>8+</sup> <sup>deprecated</sup> ## settings.setValueSync<sup>(deprecated)</sup>
> 从API version 9开始不再维护,建议使用stage模型的对应接口 > 从API version 8开始支持,从API version 9开始废弃,推荐使用[setValueSync()](#settingssetvaluesync9)
setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string): boolean setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string): boolean
...@@ -738,6 +760,8 @@ setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string): ...@@ -738,6 +760,8 @@ setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string):
**系统能力**:SystemCapability.Applications.settings.Core **系统能力**:SystemCapability.Applications.settings.Core
**模型约束**:此接口仅可在FA模型下使用。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册