Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
yang2765
Docs
提交
ab8b3223
D
Docs
项目概览
yang2765
/
Docs
与 Fork 源项目一致
Fork自
OpenHarmony / Docs
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
ab8b3223
编写于
5月 13, 2022
作者:
O
openharmony_ci
提交者:
Gitee
5月 13, 2022
浏览文件
操作
浏览文件
下载
差异文件
!3987 Update data-Preferences File Context and sample code
Merge pull request !3987 from PaDaBoo/master
上级
a91d2adf
6943b6e3
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
239 addition
and
434 deletion
+239
-434
zh-cn/application-dev/reference/apis/js-apis-data-preferences.md
...pplication-dev/reference/apis/js-apis-data-preferences.md
+239
-434
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-data-preferences.md
浏览文件 @
ab8b3223
...
...
@@ -3,7 +3,7 @@
首选项为应用提供key-value键值型的数据处理能力,支持应用持久化轻量级数据,并对其修改和查询。数据存储形式为键值对,键的类型为字符串型,值的存储数据类型包括数字型、字符型、布尔型。
>
![icon-note.gif](public_sys-resources/icon-note.gif)
**说明:**
> **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
...
...
@@ -15,7 +15,7 @@ import data_preferences from '@ohos.data.preferences';
## 常量
**系统能力
**
:
以下各项对应的系统能力均为SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
以下各项对应的系统能力均为SystemCapability.DistributedDataManager.Preferences.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
...
...
@@ -30,43 +30,25 @@ getPreferences(context: Context, name: string, callback: AsyncCallback<Prefer
读取指定首选项持久化文件,将数据加载到Preferences实例,用于数据操作,该方法使用callback方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context |
[
Context
](
js-apis-
C
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| context |
[
Context
](
js-apis-
ability-c
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| name | string | 是 | 应用程序内部数据存储名称。 |
| callback | AsyncCallback
<
[Preferences](#preferences)
>
| 是 | 回调函数。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
,
preferences
)
{
if
(
err
)
{
console
.
info
(
"
Get the preferences failed
"
)
return
;
}
preferences
.
put
(
'
startup
'
,
'
auto
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Put the value of startup failed, err:
"
+
err
)
return
}
console
.
info
(
"
Put the value of startup successfully.
"
)
preferences
.
flush
(
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Flush to file failed, err:
"
+
err
)
return
}
console
.
info
(
"
Flushed to file successfully.
"
)
})
})
})
}
```
```
ts
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
,
preferences
)
{
if
(
err
)
{
console
.
info
(
"
Get preferences failed.
"
)
return
;
}
console
.
info
(
"
Get preferences successfully.
"
)
})
```
## data_preferences.getPreferences
...
...
@@ -75,12 +57,12 @@ getPreferences(context: Context, name: string): Promise<Preferences>
读取指定首选项持久化文件,将数据加载到Preferences实例,用于数据操作,该方法使用Promise方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context |
[
Context
](
js-apis-
C
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| context |
[
Context
](
js-apis-
ability-c
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| name | string | 是 | 应用程序内部数据存储名称。 |
**返回值:**
...
...
@@ -89,32 +71,14 @@ getPreferences(context: Context, name: string): Promise<Preferences>
| Promise
<
[Preferences](#preferences)
>
| Promise实例,用于异步获取结果。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
let
promise
=
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
)
promise
.
then
((
preferences
)
=>
{
preferences
.
put
(
'
startup
'
,
'
auto
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Put the value of startup failed, err:
"
+
err
)
return
}
console
.
info
(
"
Put the value of startup successfully.
"
)
preferences
.
flush
(
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Flush to file failed, err:
"
+
err
)
return
}
console
.
info
(
"
Flushed to file successfully.
"
)
})
})
}).
catch
((
err
)
=>
{
console
.
info
(
"
Get the preferences failed
"
)
})
}
```
```
ts
let
promise
=
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
)
promise
.
then
((
preferences
)
=>
{
console
.
info
(
"
Get preferences successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Get preferences failed.
"
)
})
```
## data_preferences.deletePreferences
...
...
@@ -124,30 +88,25 @@ deletePreferences(context: Context, name: string, callback: AsyncCallback<voi
从内存中移除指定首选项持久化文件对应的Preferences单实例,并删除指定文件及其备份文件和损坏文件。
删除指定首选项持久化文件时,应用不允许再使用该实例进行数据操作,否则会出现数据一致性问题,该方法使用callback方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context |
[
Context
](
js-apis-
C
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| context |
[
Context
](
js-apis-
ability-c
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| name | string | 是 | 应用程序内部数据存储名称。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
data_preferences
.
deletePreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Deleted failed, err:
"
+
err
)
return
}
console
.
info
(
"
Deleted successfully.
"
)
})
}
```
```
ts
data_preferences
.
deletePreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Deleted preferences failed, err:
"
+
err
)
return
}
console
.
info
(
"
Deleted preferences successfully.
"
)
})
```
## data_preferences.deletePreferences
...
...
@@ -157,12 +116,12 @@ deletePreferences(context: Context, name: string): Promise<void>
从内存中移除指定首选项持久化文件对应的Preferences单实例,并删除指定文件及其备份文件和损坏文件。
删除指定首选项持久化文件时,应用不允许再使用该实例进行数据操作,否则会出现数据一致性问题,该方法使用Promise方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context |
[
Context
](
js-apis-
C
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| context |
[
Context
](
js-apis-
ability-c
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| name | string | 是 | 应用程序内部数据存储名称。 |
**返回值:**
...
...
@@ -171,19 +130,14 @@ deletePreferences(context: Context, name: string): Promise<void>
| Promise
<
void
>
| Promise实例,用于异步获取结果。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
let
promise
=
data_preferences
.
deletePreferences
(
this
.
context
,
'
mystore
'
)
promise
.
then
(()
=>
{
console
.
info
(
"
Deleted successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Deleted failed, err:
"
+
err
)
})
}
```
```
ts
let
promise
=
data_preferences
.
deletePreferences
(
this
.
context
,
'
mystore
'
)
promise
.
then
(()
=>
{
console
.
info
(
"
Deleted preferences successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Deleted preferences failed, err:
"
+
err
)
})
```
## data_preferences.removePreferencesFromCache
...
...
@@ -194,30 +148,25 @@ removePreferencesFromCache(context: Context, name: string, callback: AsyncCallba
移除Preferences单实例时,应用不允许再使用该实例进行数据操作,否则会出现数据一致性问题,该方法使用callback方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context |
[
Context
](
js-apis-
C
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| context |
[
Context
](
js-apis-
ability-c
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| name | string | 是 | 应用程序内部数据存储名称。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
data_preferences
.
removePreferencesFromCache
(
this
.
context
,
'
mystore
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Removed preferences from cache failed, err:
"
+
err
)
return
}
console
.
info
(
"
Removed preferences from cache successfully.
"
)
})
}
```
```
ts
data_preferences
.
removePreferencesFromCache
(
this
.
context
,
'
mystore
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Removed preferences from cache failed, err:
"
+
err
)
return
}
console
.
info
(
"
Removed preferences from cache successfully.
"
)
})
```
## data_preferences.removePreferencesFromCache
...
...
@@ -228,12 +177,12 @@ removePreferencesFromCache(context: Context, name: string): Promise<void>
移除Preferences单实例时,应用不允许再使用该实例进行数据操作,否则会出现数据一致性问题,该方法使用Promise方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context |
[
Context
](
js-apis-
C
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| context |
[
Context
](
js-apis-
ability-c
ontext.md
)
| 是 | 应用程序或功能的上下文。 |
| name | string | 是 | 应用程序内部数据存储名称。 |
**返回值:**
...
...
@@ -242,19 +191,14 @@ removePreferencesFromCache(context: Context, name: string): Promise<void>
| Promise
<
void
>
| Promise实例,用于异步获取结果。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
let
promise
=
data_preferences
.
removePreferencesFromCache
(
this
.
context
,
'
mystore
'
)
promise
.
then
(()
=>
{
console
.
info
(
"
Removed preferences from cache successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Removed preferences from cache failed, err:
"
+
err
)
})
}
```
```
ts
let
promise
=
data_preferences
.
removePreferencesFromCache
(
this
.
context
,
'
mystore
'
)
promise
.
then
(()
=>
{
console
.
info
(
"
Removed preferences from cache successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Removed preferences from cache failed, err:
"
+
err
)
})
```
## Preferences
...
...
@@ -268,7 +212,7 @@ get(key: string, defValue: ValueType, callback: AsyncCallback<ValueType>):
获取键对应的值,如果值为null或者非默认值类型,返回默认数据,该方法使用callback方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -278,26 +222,15 @@ get(key: string, defValue: ValueType, callback: AsyncCallback<ValueType>):
| callback | AsyncCallback
<
ValueType
>
| 是 | 回调函数。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
,
preferences
)
{
if
(
err
)
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
return
}
preferences
.
get
(
'
startup
'
,
'
default
'
,
function
(
err
,
value
)
{
if
(
err
)
{
console
.
info
(
"
Get the value of startup failed, err:
"
+
err
)
return
}
console
.
info
(
"
The value of startup is
"
+
value
)
})
})
}
```
```
ts
preferences
.
get
(
'
startup
'
,
'
default
'
,
function
(
err
,
value
)
{
if
(
err
)
{
console
.
info
(
"
Get value of startup failed, err:
"
+
err
)
return
}
console
.
info
(
"
Get value of startup is
"
+
value
)
})
```
### get
...
...
@@ -306,7 +239,7 @@ get(key: string, defValue: ValueType): Promise<ValueType>
获取键对应的值,如果值为null或者非默认值类型,返回默认数据,该方法使用Promise方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
-
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -320,24 +253,14 @@ get(key: string, defValue: ValueType): Promise<ValueType>
| Promise
<
ValueType
>
| Promise实例,用于异步获取结果。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
let
promise
=
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
)
promise
.
then
((
preferences
)
=>
{
let
promiseGet
=
preferences
.
get
(
'
startup
'
,
'
default
'
)
promiseGet
.
then
((
value
)
=>
{
console
.
info
(
"
The value of startup is
"
+
value
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Get the value of startup failed, err:
"
+
err
)
})
}).
catch
((
err
)
=>
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
})
}
```
```
ts
let
promise
=
preferences
.
get
(
'
startup
'
,
'
default
'
)
promise
.
then
((
value
)
=>
{
console
.
info
(
"
Get value of startup is
"
+
value
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Get value of startup failed, err:
"
+
err
)
})
```
### put
...
...
@@ -346,7 +269,7 @@ put(key: string, value: ValueType, callback: AsyncCallback<void>): void
首先获取指定首选项持久化文件对应的Preferences实例,然后借助Preferences API将数据写入Preferences实例,通过flush或者flushSync将Preferences实例持久化,该方法使用callback方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -356,26 +279,15 @@ put(key: string, value: ValueType, callback: AsyncCallback<void>): void
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
,
preferences
)
{
if
(
err
)
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
return
}
preferences
.
put
(
'
startup
'
,
'
auto
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Put the value of startup failed, err:
"
+
err
)
return
}
console
.
info
(
"
Put the value of startup successfully.
"
)
})
})
}
```
```
ts
preferences
.
put
(
'
startup
'
,
'
auto
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Put value of startup failed, err:
"
+
err
)
return
}
console
.
info
(
"
Put value of startup successfully.
"
)
})
```
### put
...
...
@@ -384,7 +296,7 @@ put(key: string, value: ValueType): Promise<void>
首先获取指定首选项持久化文件对应的Preferences实例,然后借助Preferences API将数据写入Preferences实例,通过flush或者flushSync将Preferences实例持久化,该方法使用Promise方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -398,24 +310,14 @@ put(key: string, value: ValueType): Promise<void>
| Promise
<
void
>
| Promise实例,用于异步处理。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
let
promise
=
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
)
promise
.
then
((
preferences
)
=>
{
let
promisePut
=
preferences
.
put
(
'
startup
'
,
'
auto
'
)
promisePut
.
then
(()
=>
{
console
.
info
(
"
Put the value of startup successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Put the value of startup failed, err:
"
+
err
)
})
}).
catch
((
err
)
=>
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
})
}
```
```
ts
let
promise
=
preferences
.
put
(
'
startup
'
,
'
auto
'
)
promise
.
then
(()
=>
{
console
.
info
(
"
Put value of startup successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Put value of startup failed, err:
"
+
err
)
})
```
### has
...
...
@@ -424,7 +326,7 @@ has(key: string, callback: AsyncCallback<boolean>): boolean
检查存储对象是否包含名为给定key的存储键值对,该方法使用callback方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -438,30 +340,19 @@ has(key: string, callback: AsyncCallback<boolean>): boolean
| boolean | true表示存在,false表示不存在。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
,
preferences
)
{
if
(
err
)
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
return
}
preferences
.
has
(
'
startup
'
,
function
(
err
,
isExist
)
{
if
(
err
)
{
console
.
info
(
"
Check the key of startup failed, err:
"
+
err
)
return
}
if
(
isExist
)
{
console
.
info
(
"
The key of startup is contained.
"
)
}
else
{
console
.
info
(
"
The key of startup dose not contain.
"
)
}
})
})
}
```
```
ts
preferences
.
has
(
'
startup
'
,
function
(
err
,
isExist
)
{
if
(
err
)
{
console
.
info
(
"
Check the key of startup failed, err:
"
+
err
)
return
}
if
(
isExist
)
{
console
.
info
(
"
The key of startup is contained.
"
)
}
else
{
console
.
info
(
"
The key of startup dose not contain.
"
)
}
})
```
### has
...
...
@@ -470,7 +361,7 @@ has(key: string): Promise<boolean>
检查存储对象是否包含名为给定key的存储键值对,该方法使用Promise方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -483,28 +374,18 @@ has(key: string): Promise<boolean>
| Promise
<
boolean
>
| Promise实例,用于异步处理。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
let
promise
=
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
)
promise
.
then
((
preferences
)
=>
{
let
promiseHas
=
preferences
.
has
(
'
startup
'
)
promiseHas
.
then
((
isExist
)
=>
{
if
(
isExist
)
{
console
.
info
(
"
The key of startup is contained.
"
)
}
else
{
console
.
info
(
"
The key of startup dose not contain.
"
)
}
}).
catch
((
err
)
=>
{
console
.
info
(
"
Check the key of startup failed, err:
"
+
err
)
})
}).
catch
((
err
)
=>
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
})
}
```
```
ts
let
promise
=
preferences
.
has
(
'
startup
'
)
promise
.
then
((
isExist
)
=>
{
if
(
isExist
)
{
console
.
info
(
"
The key of startup is contained.
"
)
}
else
{
console
.
info
(
"
The key of startup dose not contain.
"
)
}
}).
catch
((
err
)
=>
{
console
.
info
(
"
Check the key of startup failed, err:
"
+
err
)
})
```
### delete
...
...
@@ -513,7 +394,7 @@ delete(key: string, callback: AsyncCallback<void>): void
从存储对象中删除名为给定key的存储键值对,该方法使用callback方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -522,26 +403,15 @@ delete(key: string, callback: AsyncCallback<void>): void
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
,
preferences
)
{
if
(
err
)
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
return
}
preferences
.
delete
(
'
startup
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Delete startup key failed, err:
"
+
err
)
return
}
console
.
info
(
"
Deleted startup key successfully.
"
)
})
})
}
```
```
ts
preferences
.
delete
(
'
startup
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Delete startup key failed, err:
"
+
err
)
return
}
console
.
info
(
"
Deleted startup key successfully.
"
)
})
```
### delete
...
...
@@ -550,7 +420,7 @@ delete(key: string): Promise<void>
从存储对象删除名为给定key的存储键值对,该方法使用Promise方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -563,24 +433,14 @@ delete(key: string): Promise<void>
| Promise
<
void
>
| Promise实例,用于异步处理。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
let
promise
=
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
)
promise
.
then
((
preferences
)
=>
{
let
promiseDelete
=
preferences
.
delete
(
'
startup
'
)
promiseDelete
.
then
(()
=>
{
console
.
info
(
"
Deleted startup key successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Delete startup key failed, err:
"
+
err
)
})
}).
catch
((
err
)
=>
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
})
}
```
```
ts
let
promise
=
preferences
.
delete
(
'
startup
'
)
promise
.
then
(()
=>
{
console
.
info
(
"
Deleted startup key successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Delete startup key failed, err:
"
+
err
)
})
```
### flush
...
...
@@ -589,7 +449,7 @@ flush(callback: AsyncCallback<void>): void
将当前preferences对象中的修改保存到当前的preferences,并异步存储到首选项持久化文件中,该方法使用callback方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -597,26 +457,15 @@ flush(callback: AsyncCallback<void>): void
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
,
preferences
)
{
if
(
err
)
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
return
}
preferences
.
flush
(
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Flush to file failed, err:
"
+
err
)
return
}
console
.
info
(
"
Flushed to file successfully.
"
)
})
})
}
```
```
ts
preferences
.
flush
(
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Flush to file failed, err:
"
+
err
)
return
}
console
.
info
(
"
Flushed to file successfully.
"
)
})
```
### flush
...
...
@@ -625,7 +474,7 @@ flush(): Promise<void>
将当前preferences对象中的修改保存到当前的preferences,并异步存储到首选项持久化文件中,该方法使用Promise方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**返回值:**
| 类型 | 说明 |
...
...
@@ -633,24 +482,14 @@ flush(): Promise<void>
| Promise
<
void
>
| Promise实例,用于异步处理。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
let
promise
=
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
)
promise
.
then
((
preferences
)
=>
{
let
promiseFlush
=
preferences
.
flush
()
promiseFlush
.
then
(()
=>
{
console
.
info
(
"
Flushed to file successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Flush to file failed, err:
"
+
err
)
})
}).
catch
((
err
)
=>
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
})
}
```
```
ts
let
promise
=
preferences
.
flush
()
promise
.
then
(()
=>
{
console
.
info
(
"
Flushed to file successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Flush to file failed, err:
"
+
err
)
})
```
### clear
...
...
@@ -659,7 +498,7 @@ clear(callback: AsyncCallback<void>): void
清除此存储对象中的所有存储,该方法使用callback方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -667,26 +506,15 @@ clear(callback: AsyncCallback<void>): void
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
,
preferences
)
{
if
(
err
)
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
return
}
preferences
.
clear
(
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Clear to file failed, err:
"
+
err
)
return
}
console
.
info
(
"
Cleared to file successfully.
"
)
})
})
}
```
```
ts
preferences
.
clear
(
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Clear to file failed, err:
"
+
err
)
return
}
console
.
info
(
"
Cleared to file successfully.
"
)
})
```
### clear
...
...
@@ -695,7 +523,7 @@ clear(): Promise<void>
清除此存储对象中的所有存储,该方法使用Promise方式作为异步方法。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**返回值:**
| 类型 | 说明 |
...
...
@@ -703,24 +531,14 @@ clear(): Promise<void>
| Promise
<
void
>
| Promise实例,用于异步处理。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
let
promise
=
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
)
promise
.
then
((
preferences
)
=>
{
let
promiseClear
=
preferences
.
clear
()
promiseClear
.
then
(()
=>
{
console
.
info
(
"
Cleared to file successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Clear to file failed, err:
"
+
err
)
})
}).
catch
((
err
)
=>
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
})
}
```
```
ts
let
promise
=
preferences
.
clear
()
promise
.
then
(()
=>
{
console
.
info
(
"
Cleared to file successfully.
"
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Clear to file failed, err:
"
+
err
)
})
```
### on('change')
...
...
@@ -729,7 +547,7 @@ on(type: 'change', callback: Callback<{ key : string }>): void
订阅数据变更者类,订阅的key的值发生变更后,在执行flush方法后,callback方法会被回调。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 说明 |
...
...
@@ -738,37 +556,30 @@ on(type: 'change', callback: Callback<{ key : string }>): void
| callback | Callback
<
{ key : string }
>
| 回调对象实例。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
var
observer
=
function
(
key
)
{
console
.
info
(
"
The key of
"
+
key
+
"
changed.
"
)
}
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
,
preferences
)
{
if
(
err
)
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
return
}
preferences
.
on
(
'
change
'
,
observer
)
preferences
.
put
(
'
startup
'
,
'
auto
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Put the value of startup failed, err:
"
+
err
)
return
}
console
.
info
(
"
Put the value of startup successfully.
"
)
preferences
.
flush
(
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Flush to file failed, err:
"
+
err
)
return
}
console
.
info
(
"
Flushed to file successfully.
"
)
// observer will be called.
})
})
})
}
```
```
ts
var
observer
=
function
(
key
)
{
console
.
info
(
"
The key of
"
+
key
+
"
changed.
"
)
}
...
preferences
.
on
(
'
change
'
,
observer
)
preferences
.
put
(
'
startup
'
,
'
auto
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Put the value of startup failed, err:
"
+
err
)
return
}
console
.
info
(
"
Put the value of startup successfully.
"
)
preferences
.
flush
(
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Flush to file failed, err:
"
+
err
)
return
}
console
.
info
(
"
Flushed to file successfully.
"
)
// observer will be called.
})
})
```
### off('change')
...
...
@@ -777,7 +588,7 @@ off(type: 'change', callback: Callback<{ key : string }>): void
当不再进行订阅数据变更时,使用此接口取消订阅。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
**参数:**
| 参数名 | 类型 | 说明 |
...
...
@@ -786,43 +597,37 @@ off(type: 'change', callback: Callback<{ key : string }>): void
| callback | Callback
<
{ key : string }
>
| 需要取消的回调对象实例。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
import
data_preferences
from
'
@ohos.data.preferences
'
export
default
class
MainAbility
extends
Ability
{
var
observer
=
function
(
key
)
{
console
.
info
(
"
The key of
"
+
key
+
"
changed.
"
)
}
data_preferences
.
getPreferences
(
this
.
context
,
'
mystore
'
,
function
(
err
,
preferences
)
{
if
(
err
)
{
console
.
info
(
"
Get the preferences failed, err:
"
+
err
)
return
}
preferences
.
on
(
'
change
'
,
observer
)
preferences
.
put
(
'
startup
'
,
'
auto
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Put the value of startup failed, err:
"
+
err
)
return
}
console
.
info
(
"
Put the value of startup successfully.
"
)
preferences
.
flush
(
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Flush to file failed, err:
"
+
err
)
return
}
console
.
info
(
"
Flushed to file successfully.
"
)
// observer will be called.
preferences
.
off
(
'
change
'
,
observer
)
})
})
})
}
```
```
ts
var
observer
=
function
(
key
)
{
console
.
info
(
"
The key of
"
+
key
+
"
changed.
"
)
}
...
preferences
.
on
(
'
change
'
,
observer
)
preferences
.
put
(
'
startup
'
,
'
auto
'
,
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Put the value of startup failed, err:
"
+
err
)
return
}
console
.
info
(
"
Put the value of startup successfully.
"
)
preferences
.
flush
(
function
(
err
)
{
if
(
err
)
{
console
.
info
(
"
Flush to file failed, err:
"
+
err
)
return
}
console
.
info
(
"
Flushed to file successfully.
"
)
// observer will be called.
preferences
.
off
(
'
change
'
,
observer
)
})
})
```
## ValueType
用于表示允许的数据字段类型。
**系统能力
**
:
SystemCapability.DistributedDataManager.Preferences.Core
**系统能力
:**
SystemCapability.DistributedDataManager.Preferences.Core
| 名称 | 说明 |
| ------- | -------------------- |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录