你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Core.CreateAsync 方法

参考

定义

命名空间:: Microsoft.Azure.DataLake.Store

程序集:: Microsoft.Azure.DataLake.Store.dll

包:: Microsoft.Azure.DataLake.Store v1.1.24

包:: Microsoft.Azure.DataLake.Store v1.2.5-alpha

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

创建新的文件。这是一个异步操作。

对于具有不同 leaseId 的同一路径多次调用 CreateAsync 时，线程安全。

public static System.Threading.Tasks.Task CreateAsync (string path, bool overwrite, string octalPermission, string leaseId, string sessionId, bool createParent, Microsoft.Azure.DataLake.Store.SyncFlag flag, byte[] dataBytes, int offset, int length, Microsoft.Azure.DataLake.Store.AdlsClient client, Microsoft.Azure.DataLake.Store.RequestOptions req, Microsoft.Azure.DataLake.Store.OperationResponse resp, System.Threading.CancellationToken cancelToken = default);

static member CreateAsync : string * bool * string * string * string * bool * Microsoft.Azure.DataLake.Store.SyncFlag * byte[] * int * int * Microsoft.Azure.DataLake.Store.AdlsClient * Microsoft.Azure.DataLake.Store.RequestOptions * Microsoft.Azure.DataLake.Store.OperationResponse * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function CreateAsync (path As String, overwrite As Boolean, octalPermission As String, leaseId As String, sessionId As String, createParent As Boolean, flag As SyncFlag, dataBytes As Byte(), offset As Integer, length As Integer, client As AdlsClient, req As RequestOptions, resp As OperationResponse, Optional cancelToken As CancellationToken = Nothing) As Task

参数

path: String

文件的路径

overwrite: Boolean

如果标志为 true，则覆盖现有文件

octalPermission: String

八进制权限字符串

leaseId: String

包含租约 ID 的字符串，当客户端获取对文件的租约时，其他客户端无法对文件进行编辑

sessionId: String

用于在服务器上轻松获取文件处理程序 (流) 的 UUID

createParent: Boolean

如果为 true，则创建任何不存在的父目录

flag: SyncFlag

在写入数据字节时传递 SyncFlag.METADATA 时传递 SyncFlag.METADATA 时，文件的元数据（如长度、修改后的即时）需要更新，以便与文件的实际数据保持一致。传递 SyncFlag.METADATA GetFileStatus 和 ListStatus 后，返回一致数据。无需追加更多数据、更新文件元数据、释放租约和关闭流时传递 SyncFlag.CLOSE