鸿蒙开发装备管理：【@ohos.settings (设置数据项名称)】 ...

设置数据项名称

   

分析： 本模块首批接口从API version 8开始支持。后续版本如有新增内容，则采用上角标单独标志该内容的起始版本。
  本模块提供设置数据项的访问功能相干接口的分析及示例。
导入模块

1. 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。
  
• 示例：
  
  1. // 获取数据项的URI
  2. let urivar = settings.getUriSync('settings.screen.brightness');  

  复制代码

settings.getValueSync

getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: string): string
获取数据项的值。
系统能力：SystemCapability.Applictaions.settings.Core。

• 参数：
     参数名类型必填分析dataAbilityHelper[DataAbilityHelper]是数据管理辅助类。namestring是数据项的名称。数据项名称分为以下两种： - 数据库中已存在的数据项，包括：
  
  
  
  • 
    
    
    
    • 亮度：‘settings.screen.brightness’
      
    • 时间格式：‘settings.time.format’
      
    
    
  • 开发者自行添加的数据项。 |
    | defValue | string | 是 | 默认值。由开发者设置，当未从数据库中查询到该数据时，则返回该默认值。 |
    
  
  
• 返回值：
     类型分析string返回数据项的值。
  
• 示例：
  
  1. import featureAbility from '@ohos.featureAbility';
  3. //获取数据项亮度的值（该数据项在数据库中已存在）
  4. let brightness = 'settings.screen.brightness';
  5. let uri = settings.getUriSync(brightness);
  6. let helper = featureAbility.acquireDataAbilityHelper(uri);
  7. 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[DataAbilityHelper]是数据管理辅助类。namestring是数据项的名称。数据项名称分为以下两种： - 数据库中已存在的数据项，包括：
  
  
  
  • 
    
    
    
    • 亮度：‘settings.screen.brightness’
      
    • 时间格式：‘settings.time.format’
      
    
    
  • 开发者自行添加的数据项。 |
    | value | string | 是 | 数据项的具体数值。 |
    
  
  
• 返回值：
     类型分析boolean返回设置数据项的值是否成功的结果。true表示设置成功，false则表示设置失败。
  

• 示例：
  
  1. import featureAbility from '@ohos.featureAbility';
  3. //更新数据项亮度的值（该数据项在数据库中已存在，故setValueSync方法将更新该数据项的值）
  4. let brightness = 'settings.screen.brightness';
  5. let uri = settings.getUriSync(brightness);
  6. let helper = featureAbility.acquireDataAbilityHelper(uri);
  7. let ret = settings.setValueSync(helper, brightness, '100');

  复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。