鸿蒙开发装备管理:【@ohos.settings (设置数据项名称)】
设置数据项名称https://i-blog.csdnimg.cn/blog_migrate/5339535c429f03fe431885b6c3db0cb3.gif 分析: 本模块首批接口从API version 8开始支持。后续版本如有新增内容,则采用上角标单独标志该内容的起始版本。
本模块提供设置数据项的访问功能相干接口的分析及示例。
导入模块
import settings from '@ohos.settings';
settings.getUriSync
getUriSync(name: string): string
获取数据项的URI。
系统能力:SystemCapability.Applictaions.settings.Core。
[*] 参数:
参数名类型必填分析namestring是数据项的名称。数据项名称分为以下两种: - 数据库中已存在的数据项,包括:
[*]
[*]亮度:‘settings.screen.brightness’
[*]时间格式:‘settings.time.format’
[*]开发者自行添加的数据项。 |
[*] 返回值:
类型分析string数据项的URI。
[*] 示例:
// 获取数据项的URI
let urivar = settings.getUriSync('settings.screen.brightness');
settings.getValueSync
getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: string): string
获取数据项的值。
系统能力:SystemCapability.Applictaions.settings.Core。
[*] 参数:
参数名类型必填分析dataAbilityHelper是数据管理辅助类。namestring是数据项的名称。数据项名称分为以下两种: - 数据库中已存在的数据项,包括:
[*]
[*]亮度:‘settings.screen.brightness’
[*]时间格式:‘settings.time.format’
[*]开发者自行添加的数据项。 |
| defValue | string | 是 | 默认值。由开发者设置,当未从数据库中查询到该数据时,则返回该默认值。 |
[*] 返回值:
类型分析string返回数据项的值。
[*] 示例:
import featureAbility from '@ohos.featureAbility';
//获取数据项亮度的值(该数据项在数据库中已存在)
let brightness = 'settings.screen.brightness';
let uri = settings.getUriSync(brightness);
let helper = featureAbility.acquireDataAbilityHelper(uri);
let value = settings.getValueSync(helper, brightness, '10');
settings.setValueSync
setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string): boolean
设置数据项的值。 假如数据库中已经存在该数据项,则setValueSync方法将更新该数据项的值;假如数据库中尚未存在该数据项,则setValueSync方法将向数据库中插入该数据项。
需要权限:ohos.permission.WRITE_SYSTEM_SETTING。
系统能力:SystemCapability.Applictaions.settings.Core。
[*] 参数:
参数名类型必填分析dataAbilityHelper是数据管理辅助类。namestring是数据项的名称。数据项名称分为以下两种: - 数据库中已存在的数据项,包括:
[*]
[*]亮度:‘settings.screen.brightness’
[*]时间格式:‘settings.time.format’
[*]开发者自行添加的数据项。 |
| value | string | 是 | 数据项的具体数值。 |
[*] 返回值:
类型分析boolean返回设置数据项的值是否成功的结果。true表示设置成功,false则表示设置失败。
https://i-blog.csdnimg.cn/blog_migrate/614eae094892f99d7562655eaae2bd81.png#pic_center
[*] 示例:
import featureAbility from '@ohos.featureAbility';
//更新数据项亮度的值(该数据项在数据库中已存在,故setValueSync方法将更新该数据项的值)
let brightness = 'settings.screen.brightness';
let uri = settings.getUriSync(brightness);
let helper = featureAbility.acquireDataAbilityHelper(uri);
let ret = settings.setValueSync(helper, brightness, '100');
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页:
[1]