文件交互


文件交互

icon-note.gif 说明:

  • 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
  • 本模块接口后续将废弃。不建议在OpenHarmony使用以下接口,调用以下接口将抛出异常。

导入模块

import document from '@ohos.document';
1

document.choose

choose(type:string[]): Promise<string>

通过文件管理器选择文件,异步返回文件URI,使用promise形式返回结果。

系统能力:SystemCapability.FileManagement.File.FileIO

  • 参数:

    参数名 类型 必填 说明
    type string[] 限定文件选择的类型
  • 返回值:

    类型 说明
    Promise<string> 异步返回文件URI(注:当前返回错误码)
  • 示例:

    await document.choose(type);
    
    1

document.choose

choose(callback:AsyncCallback<string>): void

通过文件管理器选择文件,异步返回文件URI,使用callback形式返回结果。

系统能力:SystemCapability.FileManagement.File.FileIO

  • 参数:

    参数名 类型 必填 说明
    callback AsyncCallback<string> 异步获取对应文件URI(注:当前返回错误码)
  • 示例:

    await document.choose(function(err, uri) {
          //do something with uri
    });
    
    1
    2
    3

document.choose

choose(type:string[], callback:AsyncCallback<string>): void

通过文件管理器选择文件,异步返回文件URI,使用callback形式返回结果。

系统能力:SystemCapability.FileManagement.File.FileIO

  • 参数:

    参数名 类型 必填 说明
    type string[] 限定选择文件的类型
    callback AsyncCallback<string> 异步获取对应文件URI(注:当前返回错误码)
  • 示例:

    await document.choose(type, function(err, uri) {
          //do something with uri
    });
    
    1
    2
    3

document.show

show(url:string, type:string):Promise<number>

异步打开URI对应的文件,使用promise形式返回结果。

系统能力:SystemCapability.FileManagement.File.FileIO

  • 参数:

    参数 类型 必填 说明
    uri string 待打开的文件URI
    type string 待打开文件的类型
  • 返回值:

    类型 说明
    Promise<void> Promise回调返回void表示成功打开文件(注:当前返回错误码)
  • 示例:

    await document.show(uri, type);
    
    1

document.show

show(url:string, type:string, callback:AsyncCallback<void>): void

异步打开URI对应的文件,使用callback形式返回结果。

系统能力:SystemCapability.FileManagement.File.FileIO

  • 参数:

    参数名 类型 必填 说明
    uri string 待打开的文件URI
    type string 待打开文件的类型
    callback AsyncCallback<void> 异步打开uri对应文件(注:当前返回错误码)
  • 示例:

    await document.show(uri, type, function(err) {
          //do something
    });
    
    1
    2
    3