# @ohos.document (文件交互)

> phone 12+ | 2in1 13+ | tablet 12+ | tv 19+

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

## 导入模块

```ts
import document from '@ohos.document';
```

## document.choose^(deprecated)^

choose(types?: string[]): Promise<string>

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

**系统能力**：SystemCapability.FileManagement.UserFileService

**参数：**

|参数名|类型|必填|说明|
|:----|:-------|:-|:--------|
|types|string[]|否|限定文件选择的类型|

**返回值：**

|类型|说明|
|:--------------|:-------------------|
|Promise<string>|异步返回文件URI（注：当前返回错误码）|

**示例：**

```ts
let types: Array<string> = [];
document.choose(types);
```

## document.choose^(deprecated)^

choose(callback:AsyncCallback<string>): void

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

**系统能力**：SystemCapability.FileManagement.UserFileService

**参数：**

|参数名|类型|必填|说明|
|:-------|:--------------------|:-|:---------------------|
|callback|AsyncCallback<string>|是|异步获取对应文件URI（注：当前返回错误码）|

**示例：**

```ts
let uri: string = "";
document.choose((err: TypeError, uri: string) => {
  //do something with uri
});
```

## document.choose^(deprecated)^

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

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

**系统能力**：SystemCapability.FileManagement.UserFileService

**参数：**

|参数名|类型|必填|说明|
|:-------|:--------------------|:-|:---------------------|
|types|string[]|是|限定选择文件的类型|
|callback|AsyncCallback<string>|是|异步获取对应文件URI（注：当前返回错误码）|

**示例：**

```ts
let types: Array<string> = [];
let uri: string = "";
document.choose(types, (err: TypeError, uri: string) => {
  //do something with uri
});
```

## document.show^(deprecated)^

show(uri:string, type:string):Promise<void>

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

**系统能力**：SystemCapability.FileManagement.UserFileService

**参数：**

|参数名|类型|必填|说明|
|:---|:-----|:-|:--------|
|uri|string|是|待打开的文件URI|
|type|string|是|待打开文件的类型|

**返回值：**

|类型|说明|
|:------------|:---------------------------------|
|Promise<void>|Promise回调返回void表示成功打开文件（注：当前返回错误码）|

**示例：**

```ts
let type: string = "";
let uri: string = "";
document.show(uri, type);
```

## document.show^(deprecated)^

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

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

**系统能力**：SystemCapability.FileManagement.UserFileService

**参数：**

|参数名|类型|必填|说明|
|:-------|:------------------|:-|:---------------------|
|uri|string|是|待打开的文件URI|
|type|string|是|待打开文件的类型|
|callback|AsyncCallback<void>|是|异步打开uri对应文件（注：当前返回错误码）|

**示例：**

```ts
let type: string = "";
let uri: string = "";
document.show(uri, type, (err: TypeError) => {
  //do something
});
```