| name | string | Yes| Name of the target data item. Data items can be classified as follows:<br><ul><li>Existing data items in the database, for example:<br></li><ul><li>Brightness: 'settings.screen.brightness' <br></li><li>Time format: 'settings.time.format' <br></li></ul><li>Custom data items</li></ul>|
| name | string | Yes| Name of the target data item. Data items can be classified as follows:<br><ul><li>Existing data items in the database, for example:<br></li><ul><li>Brightness: 'settings.screen.brightness'<br></li><li>Time format: 'settings.time.format'<br></li></ul><li>Custom data items</li></ul>|
| name | string | Yes| Name of the target data item. Data items can be classified as follows:<br><ul><li>Existing data items in the database, for example:<br></li><ul><li>Brightness: 'settings.screen.brightness' <br></li><li>Time format: 'settings.time.format' <br></li></ul><li>Custom data items</li></ul>|
| name | string | Yes| Name of the target data item. Data items can be classified as follows:<br><ul><li>Existing data items in the database, for example:<br></li><ul><li>Brightness: 'settings.screen.brightness'<br></li><li>Time format: 'settings.time.format'<br></li></ul><li>Custom data items</li></ul>|
| defValue | string | Yes| Default value This parameter is user-defined. If it is not found in the database, the default value is returned.|
| defValue | string | Yes| Default value This parameter is user-defined. If it is not found in the database, the default value is returned.|
- Return value
- Return value
...
@@ -63,7 +63,7 @@ Obtains the value of a data item.
...
@@ -63,7 +63,7 @@ Obtains the value of a data item.
- Example
- Example
```
```
import featureAbility from '@ohos.featureAbility';
import featureAbility from '@ohos.featureAbility';
// Obtain the value of 'settings.screen.brightness' (this data item already exists in the database).
// Obtain the value of 'settings.screen.brightness' (this data item already exists in the database).
If the specified data item exists in the database, the **setValueSync** method updates the value of the data item. If the data item does not exist in the database, the **setValueSync** method inserts the data item into the database.
If the specified data item exists in the database, the **setValueSync** method updates the value of the data item. If the data item does not exist in the database, the **setValueSync** method inserts the data item into the database.
To use this method, you must have the **ohos.permission.WRITE_SYSTEM_SETTING** permission.
| name | string | Yes| Name of the target data item. Data items can be classified as follows:<br><ul><li>Existing data items in the database, for example:<br></li><ul><li>Brightness: 'settings.screen.brightness' <br></li><li>Time format: 'settings.time.format' <br></li></ul><li>Custom data items</li></ul>|
| name | string | Yes| Name of the target data item. Data items can be classified as follows:<br><ul><li>Existing data items in the database, for example:<br></li><ul><li>Brightness: 'settings.screen.brightness'<br></li><li>Time format: 'settings.time.format'<br></li></ul><li>Custom data items</li></ul>|
| value | string | Yes| Value of the data item.|
| value | string | Yes| Value of the data item.|
- Return value
- Return value
...
@@ -96,9 +98,9 @@ To use this method, you must have the **ohos.permission.WRITE_SYSTEM_SETTING** p
...
@@ -96,9 +98,9 @@ To use this method, you must have the **ohos.permission.WRITE_SYSTEM_SETTING** p
- Example
- Example
```
```
import featureAbility from '@ohos.featureAbility';
import featureAbility from '@ohos.featureAbility';
// Update the value of 'settings.screen.brightness'. (As this data item exists in the database, the setValueSync method
// Update the value of 'settings.screen.brightness'. (As this data item exists in the database, the setValueSync
will update the value of the data item.)
method will update the value of the data item.)
let brightness = 'settings.screen.brightness';
let brightness = 'settings.screen.brightness';
let uri = settings.getUriSync(brightness);
let uri = settings.getUriSync(brightness);
let helper = featureAbility.acquireDataAbilityHelper(uri);
let helper = featureAbility.acquireDataAbilityHelper(uri);