1# @ohos.document (文件交互)
2
3> **说明：**
4>
5> - 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
6> - 本模块接口从API version 9开始废弃。不建议使用以下接口，调用以下接口将抛出异常。
7
8## 导入模块
9
10```ts
11import document from '@ohos.document';
12```
13
14## document.choose<sup>(deprecated)</sup>
15
16choose(types?: string[]): Promise&lt;string&gt;
17
18通过文件管理器选择文件，异步返回文件URI，使用promise形式返回结果。
19
20**系统能力**：SystemCapability.FileManagement.UserFileService
21
22**参数：**
23
24  | 参数名 | 类型   | 必填 | 说明                         |
25  | ------ | ------ | ---- | ---------------------------- |
26  | types   | string[] | 否   | 限定文件选择的类型 |
27
28**返回值：**
29
30  | 类型                  | 说明           |
31  | --------------------- | -------------- |
32  | Promise&lt;string&gt; | 异步返回文件URI（注：当前返回错误码） |
33
34**示例：**
35
36  ```ts
37  let types: Array<string> = [];
38  document.choose(types);
39  ```
40## document.choose<sup>(deprecated)</sup>
41
42choose(callback:AsyncCallback&lt;string&gt;): void
43
44通过文件管理器选择文件，异步返回文件URI，使用callback形式返回结果。
45
46**系统能力**：SystemCapability.FileManagement.UserFileService
47
48**参数：**
49
50  | 参数名   | 类型                        | 必填 | 说明                         |
51  | -------- | --------------------------- | ---- | ---------------------------- |
52  | callback | AsyncCallback&lt;string&gt; | 是   | 异步获取对应文件URI（注：当前返回错误码） |
53
54**示例：**
55
56  ```ts
57  let uri: string = "";
58  document.choose((err: TypeError, uri: string) => {
59    //do something with uri
60  });
61  ```
62## document.choose<sup>(deprecated)</sup>
63
64choose(types:string[], callback:AsyncCallback&lt;string&gt;): void
65
66通过文件管理器选择文件，异步返回文件URI，使用callback形式返回结果。
67
68**系统能力**：SystemCapability.FileManagement.UserFileService
69
70**参数：**
71
72  | 参数名   | 类型                        | 必填 | 说明                         |
73  | -------- | --------------------------- | ---- | ---------------------------- |
74  | types    | string[]                      | 是   | 限定选择文件的类型 |
75  | callback | AsyncCallback&lt;string&gt; | 是   | 异步获取对应文件URI（注：当前返回错误码） |
76
77**示例：**
78
79  ```ts
80  let types: Array<string> = [];
81  let uri: string = "";
82  document.choose(types, (err: TypeError, uri: string) => {
83    //do something with uri
84  });
85  ```
86
87## document.show<sup>(deprecated)</sup>
88
89show(uri:string, type:string):Promise&lt;void&gt;
90
91异步打开URI对应的文件，使用promise形式返回结果。
92
93**系统能力**：SystemCapability.FileManagement.UserFileService
94
95**参数：**
96
97  | 参数名 | 类型   | 必填 | 说明                         |
98  | ---- | ------ | ---- | ---------------------------- |
99  | uri | string | 是   | 待打开的文件URI |
100  | type | string | 是   | 待打开文件的类型 |
101
102**返回值：**
103
104  | 类型                  | 说明         |
105  | --------------------- | ------------ |
106  | Promise&lt;void&gt; | Promise回调返回void表示成功打开文件（注：当前返回错误码） |
107
108**示例：**
109
110  ```ts
111  let type: string = "";
112  let uri: string = "";
113  document.show(uri, type);
114  ```
115
116## document.show<sup>(deprecated)</sup>
117
118show(uri:string, type:string, callback:AsyncCallback&lt;void&gt;): void
119
120异步打开URI对应的文件，使用callback形式返回结果。
121
122**系统能力**：SystemCapability.FileManagement.UserFileService
123
124**参数：**
125
126  | 参数名   | 类型                        | 必填 | 说明                         |
127  | -------- | --------------------------- | ---- | ---------------------------- |
128  | uri | string | 是   | 待打开的文件URI |
129  | type | string | 是   | 待打开文件的类型 |
130  | callback | AsyncCallback&lt;void&gt; | 是   | 异步打开uri对应文件（注：当前返回错误码）   |
131
132**示例：**
133
134  ```ts
135  let type: string = "";
136  let uri: string = "";
137  document.show(uri, type, (err: TypeError) => {
138    //do something
139  });
140  ```
141
142