update zh-cn/application-dev/database/database-preference-guidelines.md.

Signed-off-by: N@ge-yafang <geyafang@huawei.com>

zh-cn/application-dev/database/database-preference-guidelines.md

@@ -6,11 +6,17 @@
 
 ## 场景介绍
 
-首选项功能通常用于保存应用的一些常用配置信息，并不适合需要存储大量数据和频繁改变数据的场景。应用的数据保存在文件中，这些文件可以持久化地存储在设备上。需要注意的是，应用访问的实例包含文件所有数据，这些数据会一直加载在设备的内存中，直到应用主动从内存中将其移除前，应用都可以通过Preferences API进行相关数据操作。
+首选项功能通常用于保存应用的一些常用配置信息，并不适合需要存储大量数据和频繁改变数据的场景。应用的数据保存在文件中，这些文件可以持久化地存储在设备上。
+
+需要注意的是，应用访问的实例包含文件所有数据，这些数据会一直加载在设备的内存中，直到应用主动从内存中将其移除前，应用都可以通过Preferences API进行相关数据操作。
 
 ## 接口说明
 
-首选项为应用提供key-value键值型的文件数据处理能力，支持应用持久化轻量级数据，并对其修改和查询。数据存储形式为键值对，键的类型为字符串型，值的存储数据类型包括数字型、字符型、布尔型。更多首选项相关接口，请见[首选项API](../reference/apis/js-apis-data-preferences.md)。
+首选项为应用提供Key-Value键值型的文件数据处理能力，支持应用持久化轻量级数据，并对其修改和查询。
+
+数据存储形式为键值对，键的类型为字符串型，值的存储数据类型包括数字型、字符型、布尔型以及这3种类型的数组类型。
+
+更多首选项相关接口，请见[首选项API](../reference/apis/js-apis-data-preferences.md)。
 
 ### 创建存储实例
 
@@ -18,29 +24,26 @@
 
 **表1** 首选项实例创建接口
 
-| 包名              | 接口名                                      | 描述                                        |
-| ----------------- | ------------------------------------------- | ------------------------------------------- |
+| 包名                  | 接口名                                                       | 描述                                                         |
+| --------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
 | ohos.data.preferences | getPreferences(context: Context, name: string): Promise\<Preferences> | 读取指定首选项持久化文件，将数据加载到Preferences实例，用于数据操作。 |
 
-### 存入数据
+### 存取数据
 
 通过put系列方法，可以增加或修改Preferences实例中的数据。
 
-**表2** 首选项存入接口
-
-| 类名    | 接口名                                             | 描述                                            |
-| ------- | -------------------------------------------------- | ----------------------------------------------- |
-| Preferences | put(key: string, value: ValueType): Promise\<void> | 支持值为number、string、boolean、Array\<number>、Array\<string>、Array\<boolean>类型的数据存入。 |
-
-### 读取数据
-
 通过调用get系列方法，可以读取Preferences中的数据。
 
-**表3** 首选项读取接口
+通过调用getAll系列方法，可以获取Preferences中包含所有键值的Object对象。
+
+**表2** 首选项存取接口
 
-| 类名    | 接口名                                                     | 描述                                            |
-| ------- | ---------------------------------------------------------- | ----------------------------------------------- |
+| 类名        | 接口名                                                     | 描述                                                         |
+| ----------- | ---------------------------------------------------------- | ------------------------------------------------------------ |
+| Preferences | put(key: string, value: ValueType): Promise\<void>         | 支持存入值为number、string、boolean、Array\<number>、Array\<string>、Array\<boolean>类型的数据。 |
 | Preferences | get(key: string, defValue: ValueType): Promise\<ValueType> | 支持获取值为number、string、boolean、Array\<number>、Array\<string>、Array\<boolean>类型的数据。 |
+| Preferences | getAll(): Promise<Object>                                  | 支持获取含有所有键值的Object对象。                           |
+
 
 ### 数据持久化
 
@@ -48,18 +51,18 @@
 
 **表4** 首选项持久化接口
 
-| 类名    | 接口名                  | 描述                                    |
-| ------- | ----------------------- | --------------------------------------- |
+| 类名        | 接口名                  | 描述                                        |
+| ----------- | ----------------------- | ------------------------------------------- |
 | Preferences | flush(): Promise\<void> | 将Preferences实例通过异步线程回写入文件中。 |
 
 ### 订阅数据变化
 
-订阅数据变更者类，订阅的key的值发生变更后，在执行flush方法后，会执行callback回调。
+订阅数据变更者类，订阅的Key的值发生变更后，在执行flush方法后，会触发callback回调。
 
 **表5** 首选项变化订阅接口
 
-| 类名    | 接口名                                                       | 描述           |
-| ------- | ------------------------------------------------------------ | -------------- |
+| 类名        | 接口名                                                       | 描述           |
+| ----------- | ------------------------------------------------------------ | -------------- |
 | Preferences | on(type: 'change', callback: Callback<{ key : string }>): void | 订阅数据变化。 |
 | Preferences | off(type: 'change', callback: Callback<{ key : string }>): void | 注销订阅。     |
 
@@ -69,10 +72,10 @@
 
 **表6** 首选项删除接口
 
-| 包名              | 接口名                                               | 描述                                                         |
-| ----------------- | ---------------------------------------------------- | ------------------------------------------------------------ |
-| ohos.data.preferences | deletePreferences(context: Context, name: string): Promise\<void>;     | 从缓存中移除已加载的Preferences对象，同时从设备上删除对应的文件。 |
-| ohos.data.preferences | removePreferencesFromCache(context: Context, name: string): Promise\<void>; | 仅从缓存中移除已加载的Preferences对象，主要用于释放内存。
+| 包名                  | 接口名                                                       | 描述                                                         |
+| --------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| ohos.data.preferences | deletePreferences(context: Context, name: string): Promise\<void> | 从缓存中移除已加载的Preferences对象，同时从设备上删除对应的文件。 |
+| ohos.data.preferences | removePreferencesFromCache(context: Context, name: string): Promise\<void> | 仅从缓存中移除已加载的Preferences对象，主要用于释放内存。    |
 
 ## 开发步骤
 
@@ -91,7 +94,7 @@
 
 3. 存入数据。
 
-   使用Preferences put方法保存数据到缓存的实例中。
+   使用put方法保存数据到缓存的实例中。
 
    ```js
    promise.then((preferences) => {
@@ -108,7 +111,7 @@
 
 4. 读取数据。
 
-   使用Preferences get方法读取数据。
+   使用get方法读取数据。
 
    ```js
    promise.then((preferences) => {
@@ -132,7 +135,7 @@
 
 6. 订阅数据变化。
 
-   应用订阅数据变化需要指定observer作为回调方法。订阅的key的值发生变更后，当执行flush方法时，observer被触发回调。
+   应用订阅数据变化需要指定observer作为回调方法。订阅的Key的值发生变更后，当执行flush方法时，observer被触发回调。
 
    ```js
     var observer = function (key) {
@@ -169,4 +172,5 @@
    ```
 ## 相关实例
 针对首选项开发，有以下相关实例可供参考：
-- [`Preferences`：首选项（eTS）（API9）](https://gitee.com/openharmony/app_samples/tree/master/data/Preferences)
+
+- [`Preferences`：首选项（eTS）（API9）](https://gitee.com/openharmony/app_samples/tree/master/data/Preferences)
\ No newline at end of file