1# @ohos.settings (设置数据项名称)(系统接口)
2
3本模块提供访问设置数据项的能力。
4
5> **说明：**
6>
7> - 本模块首批接口从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
8> - 当前页面仅包含本模块的系统接口，其他公开接口参见[@ohos.settings (设置数据项名称)](./js-apis-settings.md)。
9
10## 导入模块
11
12```js
13import settings from '@ohos.settings';
14```
15
16## domainName
17
18提供查询的域名
19
20### 属性
21
22**系统能力：** SystemCapability.Applications.Settings.Core
23
24| 名称                | 类型   | 可读 | 可写 | 说明                                                         |
25| ------------------- | ------ | ---- | ---- | ------------------------------------------------------------ |
26| USER_SECURITY<sup>11+</sup>      | string | 是   | 是   | 用户安全属性域                                          |
27
28## settings.setValue<sup>(deprecated)</sup>
29
30setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object, callback: AsyncCallback\<boolean>): void
31
32将数据项名称及数据项的值保存到数据库中。使用callback异步回调。
33
34> **说明：**
35>
36> 从 API version 7开始支持，从API version 9开始废弃，推荐使用[setValue()](js-apis-settings.md#settingssetvalue10)。
37
38**系统接口**：此接口为系统接口。
39
40**模型约束**：此接口仅可在FA模型下使用。
41
42**系统能力**：SystemCapability.Applications.Settings.Core
43
44**参数**：
45
46| 参数名            | 类型                                                         | 必填 | 说明                                                         |
47| ----------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
48| dataAbilityHelper | [DataAbilityHelper](../apis-ability-kit/js-apis-inner-ability-dataAbilityHelper.md) | 是   | 数据管理辅助类。                                             |
49| name              | string                                                       | 是   | 数据项的名称。数据项名称分为以下两种：<br>- 上述任意一个数据库中已存在的数据项。<br>- 开发者自行添加的数据项。 |
50| value             | object                                                       | 是   | 数据项值。取值范围随业务变动。                               |
51| callback          | AsyncCallback\<boolean>                                      | 是   | 回调函数。返回true表示操作成功，否则操作失败。               |
52
53
54## settings.setValue<sup>(deprecated)</sup>
55
56setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object): Promise\<boolean>
57
58将数据项名称及数据项的值保存到数据库中。使用Promise异步回调。
59
60> **说明：**
61>
62> 从 API version 7开始支持，从API version 9开始废弃，推荐使用[setValue()](js-apis-settings.md#settingssetvalue10-1)。
63
64**系统接口**：此接口为系统接口。
65
66**模型约束**：此接口仅可在FA模型下使用。
67
68**系统能力**：SystemCapability.Applications.Settings.Core
69
70**参数**：
71
72| 参数名            | 类型                                                         | 必填 | 说明                                                         |
73| ----------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
74| dataAbilityHelper | [DataAbilityHelper](../apis-ability-kit/js-apis-inner-ability-dataAbilityHelper.md) | 是   | 数据管理辅助类。                                             |
75| name              | string                                                       | 是   | 数据项的名称。数据项名称分为以下两种：<br>- 上述任意一个数据库中已存在的数据项。<br>- 开发者自行添加的数据项。 |
76| value             | object                                                       | 是   | 数据项值。取值范围随业务变动。                               |
77
78**返回值**：
79
80| 类型              | 说明                                               |
81| ----------------- | -------------------------------------------------- |
82| Promise\<boolean> | Promise对象。返回true表示操作成功，否则返回false。 |
83
84