js-apis-ability-dataUriUtils.md 3.1 KB
Newer Older
X
xuchenghua09 已提交
1 2
# DataUriUtils模块

Z
zhuhan 已提交
3
DataUriUtils模块提供用于处理使用DataAbilityHelper方案的对象的实用程序类的能力,包括获取,添加,更新给定uri的路径组件末尾的ID。本模块将被app.ability.dataUriUtils模块,建议优先使用[@ohos.app.ability.dataUriUtils](js-apis-app-ability-dataUriUtils.md)模块。
Y
yuyaozhi 已提交
4

Y
yuyaozhi 已提交
5 6
> **说明:**
> 
7 8
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

X
xuchenghua09 已提交
9 10
## 导入模块

M
m00512953 已提交
11
```ts
X
xuchenghua09 已提交
12 13 14
import dataUriUtils from '@ohos.ability.dataUriUtils';
```

Z
zengyawen 已提交
15
## dataUriUtils.getId
X
xuchenghua09 已提交
16

Z
zengyawen 已提交
17
getId(uri: string): number
X
xuchenghua09 已提交
18

Z
zengyawen 已提交
19
获取附加到给定uri的路径组件末尾的ID。
X
xuchenghua09 已提交
20

Y
yuyaozhi 已提交
21
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
X
xuchenghua09 已提交
22

Y
yuyaozhi 已提交
23
**参数:**
X
xuchenghua09 已提交
24

D
donglin 已提交
25
| 参数名 | 类型   | 必填 | 说明                        |
Z
zengyawen 已提交
26 27
| ---- | ------ | ---- | --------------------------- |
| uri  | string | 是   | 指示要从中获取ID的uri对象。 |
X
xuchenghua09 已提交
28

Z
zengyawen 已提交
29
**返回值:**
Y
yuyaozhi 已提交
30

Z
zengyawen 已提交
31 32 33
| 类型   | 说明                     |
| ------ | ------------------------ |
| number | 附加到路径组件末尾的ID。 |
X
xuchenghua09 已提交
34

Z
zengyawen 已提交
35
**示例:**
X
xuchenghua09 已提交
36

M
m00512953 已提交
37
```ts
Y
yuyaozhi 已提交
38
dataUriUtils.getId("com.example.dataUriUtils/1221")
X
xuchenghua09 已提交
39 40 41 42
```



Z
zengyawen 已提交
43
## dataUriUtils.attachId
X
xuchenghua09 已提交
44

Z
zengyawen 已提交
45
attachId(uri: string, id: number): string
X
xuchenghua09 已提交
46

Z
zengyawen 已提交
47
将给定ID附加到给定uri的路径组件的末尾。
X
xuchenghua09 已提交
48

Y
yuyaozhi 已提交
49
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
X
xuchenghua09 已提交
50

Y
yuyaozhi 已提交
51
**参数:**
X
xuchenghua09 已提交
52

D
donglin 已提交
53
| 参数名 | 类型   | 必填 | 说明                        |
Z
zengyawen 已提交
54 55 56
| ---- | ------ | ---- | --------------------------- |
| uri  | string | 是   | 指示要从中获取ID的uri对象。 |
| id   | number | 是   | 指示要附加的ID。            |
X
xuchenghua09 已提交
57

Z
zengyawen 已提交
58
**返回值:**
Y
yuyaozhi 已提交
59

Z
zengyawen 已提交
60 61 62
| 类型   | 说明                  |
| ------ | --------------------- |
| string | 附加给定ID的uri对象。 |
X
xuchenghua09 已提交
63

Z
zengyawen 已提交
64
**示例:**
X
xuchenghua09 已提交
65

M
m00512953 已提交
66
```ts
X
xuchenghua09 已提交
67 68
var idint = 1122;
dataUriUtils.attachId(
ahjxliubao2's avatar
ahjxliubao2 已提交
69
    "com.example.dataUriUtils",
X
xuchenghua09 已提交
70 71 72 73 74 75
	idint,
)
```



Z
zengyawen 已提交
76
## dataUriUtils.deleteId
X
xuchenghua09 已提交
77

Z
zengyawen 已提交
78
deleteId(uri: string): string
X
xuchenghua09 已提交
79

Z
zengyawen 已提交
80
从给定uri的路径组件的末尾删除ID。
X
xuchenghua09 已提交
81

Y
yuyaozhi 已提交
82 83
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

Z
zengyawen 已提交
84
**参数:**
X
xuchenghua09 已提交
85

D
donglin 已提交
86
| 参数名 | 类型   | 必填 | 说明                        |
Z
zengyawen 已提交
87 88
| ---- | ------ | ---- | --------------------------- |
| uri  | string | 是   | 指示要从中删除ID的uri对象。 |
X
xuchenghua09 已提交
89

Z
zengyawen 已提交
90
**返回值:**
Y
yuyaozhi 已提交
91

Z
zengyawen 已提交
92 93 94
| 类型   | 说明                |
| ------ | ------------------- |
| string | ID已删除的uri对象。 |
X
xuchenghua09 已提交
95

Z
zengyawen 已提交
96
**示例:**
X
xuchenghua09 已提交
97

M
m00512953 已提交
98
```ts
X
xuchenghua09 已提交
99 100 101 102 103
dataUriUtils.deleteId("com.example.dataUriUtils/1221")
```



Z
zengyawen 已提交
104
## dataUriUtils.updateId
X
xuchenghua09 已提交
105

Z
zengyawen 已提交
106
updateId(uri: string, id: number): string
X
xuchenghua09 已提交
107

Z
zengyawen 已提交
108
更新指定uri中的ID。
X
xuchenghua09 已提交
109

Y
yuyaozhi 已提交
110 111
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

Z
zengyawen 已提交
112
**参数:**
X
xuchenghua09 已提交
113

D
donglin 已提交
114
| 参数名 | 类型   | 必填 | 说明                |
Z
zengyawen 已提交
115 116 117
| ---- | ------ | ---- | ------------------- |
| uri  | string | 是   | 指示要更新的uri对象 |
| id   | number | 是   | 指示新ID            |
X
xuchenghua09 已提交
118

Z
zengyawen 已提交
119
**返回值:**
Y
yuyaozhi 已提交
120

Z
zengyawen 已提交
121 122 123
| 类型   | 说明            |
| ------ | --------------- |
| string | 更新的uri对象。 |
X
xuchenghua09 已提交
124

Z
zengyawen 已提交
125
**示例:**
X
xuchenghua09 已提交
126

M
m00512953 已提交
127
```ts
X
xuchenghua09 已提交
128 129
var idint = 1122;
dataUriUtils.updateId(
ahjxliubao2's avatar
ahjxliubao2 已提交
130 131
    "com.example.dataUriUtils",
	idint
X
xuchenghua09 已提交
132 133 134
)
```