• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.data.ValuesBucket (数据集)
2<!--Kit: ArkData-->
3<!--Subsystem: DistributedDataManager-->
4<!--Owner: @woodenarow-->
5<!--Designer: @woodenarow; @xuelei3-->
6<!--Tester: @chenwan188; @logic42-->
7<!--Adviser: @ge-yafang-->
8
9**数据集(ValuesBucket)** 是开发者向数据库插入的数据集合,数据集以键值对的形式进行传输。
10
11> **说明:**
12>
13> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
14>
15> 本模块接口仅可在Stage模型下使用。
16
17
18## 导入模块
19
20```ts
21import { ValueType, ValuesBucket } from '@kit.ArkData';
22```
23
24## ValueType
25
26type ValueType = number | string | boolean
27
28该类型用于表示数据库允许的数据字段类型。
29
30**系统能力:**  SystemCapability.DistributedDataManager.DataShare.Core
31
32**原子化服务API:**  从API version 20开始,该接口支持在原子化服务中使用。
33
34| 类型    | 说明                 |
35| ------- | -------------------- |
36| number  | 表示字段类型为数字。   |
37| string  | 表示字段类型为字符串。 |
38| boolean | 表示字段类型为布尔值。 |
39
40## ValuesBucket
41
42type ValuesBucket = Record<string, ValueType | Uint8Array | null>
43
44用于存储键值对的类型。该类型不是多线程安全的,如果应用中存在多线程同时操作该类派生出的实例,注意加锁保护。
45
46**系统能力:**  SystemCapability.DistributedDataManager.DataShare.Core
47
48| 类型          | 说明                                      |
49| ------------- | --------------------------------------------- |
50| Record<string, [ValueType](#valuetype) \| Uint8Array \| null> | 表示键值对类型。键的类型为string,值的类型为[ValueType](#valuetype) \| Uint8Array \| null。|
51