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 38try { 39 let id = dataUriUtils.getId('com.example.dataUriUtils/1221'); 40 console.info('get id: ${id}'); 41} catch(err) { 42 console.error('get id err ,check the uri ${err}'); 43} 44``` 45 46 47 48## dataUriUtils.attachId 49 50attachId(uri: string, id: number): string 51 52将ID附加到uri的路径末尾。 53 54**系统能力**:SystemCapability.Ability.AbilityRuntime.Core 55 56**参数:** 57 58| 参数名 | 类型 | 必填 | 说明 | 59| ---- | ------ | ---- | --------------------------- | 60| uri | string | 是 | 表示uri对象。 | 61| id | number | 是 | 表示要附加的ID。 | 62 63**返回值:** 64 65| 类型 | 说明 | 66| ------ | --------------------- | 67| string | 返回附加ID之后的uri对象。 | 68 69**示例:** 70 71```ts 72let id = 1122; 73try { 74 let uri = dataUriUtils.attachId( 75 'com.example.dataUriUtils', 76 id, 77 ); 78 console.info('attachId the uri is: ${uri}'); 79} catch (err) { 80 console.error('get id err ,check the uri ${err}'); 81} 82 83``` 84 85 86 87## dataUriUtils.deleteId 88 89deleteId(uri: string): string 90 91删除指定uri路径末尾的ID。 92 93**系统能力**:SystemCapability.Ability.AbilityRuntime.Core 94 95**参数:** 96 97| 参数名 | 类型 | 必填 | 说明 | 98| ---- | ------ | ---- | --------------------------- | 99| uri | string | 是 | 表示要从中删除ID的uri对象。 | 100 101**返回值:** 102 103| 类型 | 说明 | 104| ------ | ------------------- | 105| string | 返回删除ID之后的uri对象。 | 106 107**示例:** 108 109```ts 110try { 111 let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221'); 112 console.info('delete id with the uri is: ${uri}'); 113} catch(err) { 114 console.error('delete uri err, check the input uri ${err}'); 115} 116 117``` 118 119 120 121## dataUriUtils.updateId 122 123updateId(uri: string, id: number): string 124 125更新指定uri中的ID。 126 127**系统能力**:SystemCapability.Ability.AbilityRuntime.Core 128 129**参数:** 130 131| 参数名 | 类型 | 必填 | 说明 | 132| ---- | ------ | ---- | ------------------- | 133| uri | string | 是 | 表示uri对象 | 134| id | number | 是 | 表示要更新的ID | 135 136**返回值:** 137 138| 类型 | 说明 | 139| ------ | --------------- | 140| string | 返回更新ID之后的uri对象。 | 141 142**示例:** 143 144```ts 145 146try { 147 let id = 1122; 148 let uri = dataUriUtils.updateId( 149 'com.example.dataUriUtils/1221', 150 id 151 ); 152} catch (err) { 153 console.error('delete uri err, check the input uri ${err}'); 154} 155``` 156 157