1# @ohos.app.ability.dataUriUtils (DataUriUtils模块) 2 3DataUriUtils模块提供用于处理uri对象的能力,包括获取、绑定、删除和更新指定uri对象的路径末尾的ID。 4 5> **说明:** 6> 7> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 8 9## 导入模块 10 11```ts 12import dataUriUtils from '@ohos.app.ability.dataUriUtils'; 13``` 14 15## dataUriUtils.getId 16 17getId(uri: string): number 18 19获取指定uri路径末尾的ID。 20 21**系统能力**:SystemCapability.Ability.AbilityRuntime.Core 22 23**参数:** 24 25| 参数名 | 类型 | 必填 | 说明 | 26| ---- | ------ | ---- | --------------------------- | 27| uri | string | 是 | 表示uri对象。 | 28 29**返回值:** 30 31| 类型 | 说明 | 32| ------ | ------------------------ | 33| number | 返回uri路径末尾的ID。 | 34 35**示例:** 36 37```ts 38import dataUriUtils from '@ohos.app.ability.dataUriUtils'; 39 40try { 41 let id = dataUriUtils.getId('com.example.dataUriUtils/1221'); 42 console.info('get id: ${id}'); 43} catch(err) { 44 console.error('get id err ,check the uri ${err}'); 45} 46``` 47 48 49 50## dataUriUtils.attachId 51 52attachId(uri: string, id: number): string 53 54将ID附加到uri的路径末尾。 55 56**系统能力**:SystemCapability.Ability.AbilityRuntime.Core 57 58**参数:** 59 60| 参数名 | 类型 | 必填 | 说明 | 61| ---- | ------ | ---- | --------------------------- | 62| uri | string | 是 | 表示uri对象。 | 63| id | number | 是 | 表示要附加的ID。 | 64 65**返回值:** 66 67| 类型 | 说明 | 68| ------ | --------------------- | 69| string | 返回附加ID之后的uri对象。 | 70 71**示例:** 72 73```ts 74import dataUriUtils from '@ohos.app.ability.dataUriUtils'; 75 76let id = 1122; 77try { 78 let uri = dataUriUtils.attachId( 79 'com.example.dataUriUtils', 80 id, 81 ); 82 console.info('attachId the uri is: ${uri}'); 83} catch (err) { 84 console.error('get id err ,check the uri ${err}'); 85} 86 87``` 88 89 90 91## dataUriUtils.deleteId 92 93deleteId(uri: string): string 94 95删除指定uri路径末尾的ID。 96 97**系统能力**:SystemCapability.Ability.AbilityRuntime.Core 98 99**参数:** 100 101| 参数名 | 类型 | 必填 | 说明 | 102| ---- | ------ | ---- | --------------------------- | 103| uri | string | 是 | 表示要从中删除ID的uri对象。 | 104 105**返回值:** 106 107| 类型 | 说明 | 108| ------ | ------------------- | 109| string | 返回删除ID之后的uri对象。 | 110 111**示例:** 112 113```ts 114import dataUriUtils from '@ohos.app.ability.dataUriUtils'; 115 116try { 117 let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221'); 118 console.info('delete id with the uri is: ${uri}'); 119} catch(err) { 120 console.error('delete uri err, check the input uri ${err}'); 121} 122 123``` 124 125 126 127## dataUriUtils.updateId 128 129updateId(uri: string, id: number): string 130 131更新指定uri中的ID。 132 133**系统能力**:SystemCapability.Ability.AbilityRuntime.Core 134 135**参数:** 136 137| 参数名 | 类型 | 必填 | 说明 | 138| ---- | ------ | ---- | ------------------- | 139| uri | string | 是 | 表示uri对象 | 140| id | number | 是 | 表示要更新的ID | 141 142**返回值:** 143 144| 类型 | 说明 | 145| ------ | --------------- | 146| string | 返回更新ID之后的uri对象。 | 147 148**示例:** 149 150```ts 151import dataUriUtils from '@ohos.app.ability.dataUriUtils'; 152 153try { 154 let id = 1122; 155 let uri = dataUriUtils.updateId( 156 'com.example.dataUriUtils/1221', 157 id 158 ); 159} catch (err) { 160 console.error('delete uri err, check the input uri ${err}'); 161} 162``` 163 164