1# Interface (FetchResult) 2 3> **说明:** 4> 5> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 6 7文件检索结果集。 8 9## 导入模块 10 11```ts 12import { photoAccessHelper } from '@kit.MediaLibraryKit'; 13``` 14 15## getCount 16 17getCount(): number 18 19获取文件检索结果中的文件总数。 20 21**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 22 23**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 24 25**返回值:** 26 27| 类型 | 说明 | 28| ------ | -------- | 29| number | 检索到的文件总数。 | 30 31**错误码:** 32 33接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 34 35| 错误码ID | 错误信息 | 36| -------- | ---------------------------------------- | 37| 13900020 | Invalid argument. | 38| 14000011 | System inner fail. | 39 40**示例:** 41 42phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 43 44```ts 45import { dataSharePredicates } from '@kit.ArkData'; 46 47async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 48 console.info('getCountDemo'); 49 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 50 let fetchOption: photoAccessHelper.FetchOptions = { 51 fetchColumns: [], 52 predicates: predicates 53 }; 54 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 55 let fetchCount = fetchResult.getCount(); 56 console.info('fetchCount = ', fetchCount); 57} 58``` 59 60## isAfterLast 61 62isAfterLast(): boolean 63 64检查结果集是否指向最后一行。 65 66**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 67 68**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 69 70**返回值:** 71 72| 类型 | 说明 | 73| ------- | ---------------------------------- | 74| boolean | 当读到最后一条记录后,后续没有记录返回true,否则返回false。 | 75 76**错误码:** 77 78接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 79 80| 错误码ID | 错误信息 | 81| -------- | ---------------------------------------- | 82| 13900020 | Invalid argument. | 83| 14000011 | System inner fail. | 84 85**示例:** 86 87phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 88 89```ts 90import { dataSharePredicates } from '@kit.ArkData'; 91 92async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 93 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 94 let fetchOption: photoAccessHelper.FetchOptions = { 95 fetchColumns: [], 96 predicates: predicates 97 }; 98 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 99 let fetchCount = fetchResult.getCount(); 100 console.info('count:' + fetchCount); 101 let photoAsset: photoAccessHelper.PhotoAsset = await fetchResult.getLastObject(); 102 if (fetchResult.isAfterLast()) { 103 console.info('photoAsset isAfterLast displayName = ', photoAsset.displayName); 104 } else { 105 console.info('photoAsset not isAfterLast.'); 106 } 107} 108``` 109 110## close 111 112close(): void 113 114释放FetchResult实例并使其失效,无法再调用其他方法。 115 116**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 117 118**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 119 120**错误码:** 121 122接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 123 124| 错误码ID | 错误信息 | 125| -------- | ---------------------------------------- | 126| 13900020 | Invalid argument. | 127| 14000011 | System inner fail. | 128 129**示例:** 130 131phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 132 133```ts 134import { dataSharePredicates } from '@kit.ArkData'; 135 136async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 137 console.info('fetchResultCloseDemo'); 138 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 139 let fetchOption: photoAccessHelper.FetchOptions = { 140 fetchColumns: [], 141 predicates: predicates 142 }; 143 try { 144 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 145 fetchResult.close(); 146 console.info('close succeed.'); 147 } catch (err) { 148 console.error(`close fail. error: ${err.code}, ${err.message}`); 149 } 150} 151``` 152 153## getFirstObject 154 155getFirstObject(callback: AsyncCallback<T>): void 156 157获取文件检索结果中的第一个文件资产。此方法使用callback形式返回结果。 158 159**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 160 161**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 162 163**参数:** 164 165| 参数名 | 类型 | 必填 | 说明 | 166| -------- | --------------------------------------------- | ---- | ------------------------------------------- | 167| callback | AsyncCallback<T> | 是 | 异步获取结果集中的第一个文件资产完成后的回调。 | 168 169**错误码:** 170 171接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 172 173| 错误码ID | 错误信息 | 174| -------- | ---------------------------------------- | 175| 13900020 | Invalid argument. | 176| 14000011 | System inner fail. | 177 178**示例:** 179 180phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 181 182```ts 183import { dataSharePredicates } from '@kit.ArkData'; 184 185async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 186 console.info('getFirstObjectDemo'); 187 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 188 let fetchOption: photoAccessHelper.FetchOptions = { 189 fetchColumns: [], 190 predicates: predicates 191 }; 192 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 193 fetchResult.getFirstObject((err, photoAsset) => { 194 if (photoAsset !== undefined) { 195 console.info('photoAsset displayName: ', photoAsset.displayName); 196 } else { 197 console.error(`photoAsset failed with err:${err.code}, ${err.message}`); 198 } 199 }); 200} 201``` 202 203## getFirstObject 204 205getFirstObject(): Promise<T> 206 207获取文件检索结果中的第一个文件资产。此方法使用promise方式来异步返回。 208 209**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 210 211**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 212 213**返回值:** 214 215| 类型 | 说明 | 216| --------------------------------------- | -------------------------- | 217| Promise<T> | Promise对象,返回结果集中第一个对象。 | 218 219**错误码:** 220 221接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 222 223| 错误码ID | 错误信息 | 224| -------- | ---------------------------------------- | 225| 13900020 | Invalid argument. | 226| 14000011 | System inner fail. | 227 228**示例:** 229 230phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 231 232```ts 233import { dataSharePredicates } from '@kit.ArkData'; 234 235async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 236 console.info('getFirstObjectDemo'); 237 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 238 let fetchOption: photoAccessHelper.FetchOptions = { 239 fetchColumns: [], 240 predicates: predicates 241 }; 242 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 243 let photoAsset: photoAccessHelper.PhotoAsset = await fetchResult.getFirstObject(); 244 console.info('photoAsset displayName: ', photoAsset.displayName); 245} 246``` 247 248## getNextObject 249 250getNextObject(callback: AsyncCallback<T>): void 251 252获取文件检索结果中的下一个文件资产。此方法使用callback形式返回结果。 253在调用此方法之前,必须使用[isAfterLast()](#isafterlast)来检查当前位置是否为最后一行。 254 255**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 256 257**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 258 259**参数:** 260 261| 参数名 | 类型 | 必填 | 说明 | 262| --------- | --------------------------------------------- | ---- | ----------------------------------------- | 263| callback | AsyncCallback<T> | 是 | 异步获取结果集中的下一个完成后的回调。 | 264 265**错误码:** 266 267接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 268 269| 错误码ID | 错误信息 | 270| -------- | ---------------------------------------- | 271| 13900020 | Invalid argument. | 272| 14000011 | System inner fail. | 273 274**示例:** 275 276phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 277 278```ts 279import { dataSharePredicates } from '@kit.ArkData'; 280 281async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 282 console.info('getNextObjectDemo'); 283 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 284 let fetchOption: photoAccessHelper.FetchOptions = { 285 fetchColumns: [], 286 predicates: predicates 287 }; 288 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 289 await fetchResult.getFirstObject(); 290 if (!fetchResult.isAfterLast()) { 291 fetchResult.getNextObject((err, photoAsset) => { 292 if (photoAsset !== undefined) { 293 console.info('photoAsset displayName: ', photoAsset.displayName); 294 } else { 295 console.error(`photoAsset failed with err: ${err.code}, ${err.message}`); 296 } 297 }); 298 } 299} 300``` 301 302## getNextObject 303 304getNextObject(): Promise<T> 305 306获取文件检索结果中的下一个文件资产。此方法使用promise方式来异步返回。 307在调用此方法之前,必须使用[isAfterLast()](#isafterlast)来检查当前位置是否为最后一行。 308 309**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 310 311**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 312 313**返回值:** 314 315| 类型 | 说明 | 316| --------------------------------------- | ----------------- | 317| Promise<T> | Promise对象,返回结果集中下一个对象。 | 318 319**错误码:** 320 321接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 322 323| 错误码ID | 错误信息 | 324| -------- | ---------------------------------------- | 325| 13900020 | Invalid argument. | 326| 14000011 | System inner fail. | 327 328**示例:** 329 330phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 331 332```ts 333import { dataSharePredicates } from '@kit.ArkData'; 334 335async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 336 console.info('getNextObjectDemo'); 337 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 338 let fetchOption: photoAccessHelper.FetchOptions = { 339 fetchColumns: [], 340 predicates: predicates 341 }; 342 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 343 await fetchResult.getFirstObject(); 344 if (!fetchResult.isAfterLast()) { 345 let photoAsset: photoAccessHelper.PhotoAsset = await fetchResult.getNextObject(); 346 console.info('photoAsset displayName: ', photoAsset.displayName); 347 } 348} 349``` 350 351## getLastObject 352 353getLastObject(callback: AsyncCallback<T>): void 354 355获取文件检索结果中的最后一个文件资产。此方法使用callback方式来返回。 356 357**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 358 359**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 360 361**参数:** 362 363| 参数名 | 类型 | 必填 | 说明 | 364| -------- | --------------------------------------------- | ---- | --------------------------- | 365| callback | AsyncCallback<T> | 是 | 异步返回结果集中最后一个的回调。 | 366 367**错误码:** 368 369接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 370 371| 错误码ID | 错误信息 | 372| -------- | ---------------------------------------- | 373| 13900020 | Invalid argument. | 374| 14000011 | System inner fail. | 375 376**示例:** 377 378phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 379 380```ts 381import { dataSharePredicates } from '@kit.ArkData'; 382 383async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 384 console.info('getLastObjectDemo'); 385 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 386 let fetchOption: photoAccessHelper.FetchOptions = { 387 fetchColumns: [], 388 predicates: predicates 389 }; 390 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 391 fetchResult.getLastObject((err, photoAsset) => { 392 if (photoAsset !== undefined) { 393 console.info('photoAsset displayName: ', photoAsset.displayName); 394 } else { 395 console.error(`photoAsset failed with err: ${err.code}, ${err.message}`); 396 } 397 }); 398} 399``` 400 401## getLastObject 402 403getLastObject(): Promise<T> 404 405获取文件检索结果中的最后一个文件资产。此方法使用Promise方式来返回。 406 407**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 408 409**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 410 411**返回值:** 412 413| 类型 | 说明 | 414| --------------------------------------- | ----------------- | 415| Promise<T> | Promise对象,返回结果集中的最后一个对象。 | 416 417**错误码:** 418 419接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 420 421| 错误码ID | 错误信息 | 422| -------- | ---------------------------------------- | 423| 13900020 | Invalid argument. | 424| 14000011 | System inner fail. | 425 426**示例:** 427 428phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 429 430```ts 431import { dataSharePredicates } from '@kit.ArkData'; 432 433async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 434 console.info('getLastObjectDemo'); 435 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 436 let fetchOption: photoAccessHelper.FetchOptions = { 437 fetchColumns: [], 438 predicates: predicates 439 }; 440 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 441 let photoAsset: photoAccessHelper.PhotoAsset = await fetchResult.getLastObject(); 442 console.info('photoAsset displayName: ', photoAsset.displayName); 443} 444``` 445 446## getObjectByPosition 447 448getObjectByPosition(index: number, callback: AsyncCallback<T>): void 449 450获取文件检索结果中具有指定索引的文件资产。此方法使用callback来返回。 451 452**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 453 454**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 455 456**参数:** 457 458| 参数名 | 类型 | 必填 | 说明 | 459| -------- | ---------------------------------------- | ---- | ------------------ | 460| index | number | 是 | 要获取的文件的索引,从0开始。 | 461| callback | AsyncCallback<T> | 是 | 异步返回指定索引的文件资产的回调。 | 462 463**错误码:** 464 465接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 466 467| 错误码ID | 错误信息 | 468| -------- | ---------------------------------------- | 469| 13900020 | Invalid argument. | 470| 14000011 | System inner fail. | 471 472**示例:** 473 474phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 475 476```ts 477import { dataSharePredicates } from '@kit.ArkData'; 478 479async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 480 console.info('getObjectByPositionDemo'); 481 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 482 let fetchOption: photoAccessHelper.FetchOptions = { 483 fetchColumns: [], 484 predicates: predicates 485 }; 486 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 487 fetchResult.getObjectByPosition(0, (err, photoAsset) => { 488 if (photoAsset !== undefined) { 489 console.info('photoAsset displayName: ', photoAsset.displayName); 490 } else { 491 console.error(`photoAsset failed with err: ${err.code}, ${err.message}`); 492 } 493 }); 494} 495``` 496 497## getObjectByPosition 498 499getObjectByPosition(index: number): Promise<T> 500 501获取文件检索结果中指定索引的文件资产。此方法返回Promise形式的文件Asset。 502 503**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 504 505**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 506 507**参数:** 508 509| 参数名 | 类型 | 必填 | 说明 | 510| ----- | ------ | ---- | -------------- | 511| index | number | 是 | 要获取的文件的索引,从0开始。 | 512 513**返回值:** 514 515| 类型 | 说明 | 516| --------------------------------------- | ----------------- | 517| Promise<T> | Promise对象,返回结果集中指定索引的一个对象。 | 518 519**错误码:** 520 521接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 522 523| 错误码ID | 错误信息 | 524| -------- | ---------------------------------------- | 525| 13900020 | Invalid argument. | 526| 14000011 | System inner fail. | 527 528**示例:** 529 530phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 531 532```ts 533import { dataSharePredicates } from '@kit.ArkData'; 534 535async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 536 console.info('getObjectByPositionDemo'); 537 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 538 let fetchOption: photoAccessHelper.FetchOptions = { 539 fetchColumns: [], 540 predicates: predicates 541 }; 542 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 543 let photoAsset: photoAccessHelper.PhotoAsset = await fetchResult.getObjectByPosition(0); 544 console.info('photoAsset displayName: ', photoAsset.displayName); 545} 546``` 547 548## getAllObjects 549 550getAllObjects(callback: AsyncCallback<Array<T>>): void 551 552获取文件检索结果中的所有文件资产。此方法使用callback形式返回结果。 553 554**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 555 556**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 557 558**参数:** 559 560| 参数名 | 类型 | 必填 | 说明 | 561| -------- | --------------------------------------------- | ---- | ------------------------------------------- | 562| callback | AsyncCallback<Array<T>> | 是 | 异步获取结果集中的所有文件资产的回调。 | 563 564**错误码:** 565 566接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 567 568| 错误码ID | 错误信息 | 569| -------- | ---------------------------------------- | 570| 13900020 | Invalid argument. | 571| 14000011 | System inner fail. | 572 573**示例:** 574 575phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 576 577```ts 578import { dataSharePredicates } from '@kit.ArkData'; 579 580async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 581 console.info('getAllObjectDemo'); 582 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 583 let fetchOption: photoAccessHelper.FetchOptions = { 584 fetchColumns: [], 585 predicates: predicates 586 }; 587 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 588 fetchResult.getAllObjects((err, photoAssetList) => { 589 if (photoAssetList !== undefined) { 590 console.info('photoAssetList length: ', photoAssetList.length); 591 } else { 592 console.error(`photoAssetList failed with err:${err.code}, ${err.message}`); 593 } 594 }); 595} 596``` 597 598## getAllObjects 599 600getAllObjects(): Promise<Array<T>> 601 602获取文件检索结果中的所有文件资产。此方法使用promise方式来异步返回。 603 604**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 605 606**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core 607 608**返回值:** 609 610| 类型 | 说明 | 611| --------------------------------------- | -------------------------- | 612| Promise<Array<T>> | Promise对象,返回所有文件资产的数组。 | 613 614**错误码:** 615 616接口抛出错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[文件管理错误码](../apis-core-file-kit/errorcode-filemanagement.md)。 617 618| 错误码ID | 错误信息 | 619| -------- | ---------------------------------------- | 620| 13900020 | Invalid argument. | 621| 14000011 | System inner fail. | 622 623**示例:** 624 625phAccessHelper的创建请参考[photoAccessHelper.getPhotoAccessHelper](arkts-apis-photoAccessHelper-f.md#photoaccesshelpergetphotoaccesshelper)的示例使用。 626 627```ts 628import { dataSharePredicates } from '@kit.ArkData'; 629 630async function example(phAccessHelper: photoAccessHelper.PhotoAccessHelper) { 631 console.info('getAllObjectDemo'); 632 let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates(); 633 let fetchOption: photoAccessHelper.FetchOptions = { 634 fetchColumns: [], 635 predicates: predicates 636 }; 637 let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption); 638 let photoAssetList: Array<photoAccessHelper.PhotoAsset> = await fetchResult.getAllObjects(); 639 console.info('photoAssetList length: ', photoAssetList.length); 640} 641``` 642