你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Core.AppendAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将数据追加到文件。 这是一个异步操作。
对于不同线程的同一路径调用 AppendAsync 时,线程安全。
public static System.Threading.Tasks.Task AppendAsync (string path, string leaseId, string sessionId, Microsoft.Azure.DataLake.Store.SyncFlag flag, long offsetFile, 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 AppendAsync : string * string * string * Microsoft.Azure.DataLake.Store.SyncFlag * int64 * 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 AppendAsync (path As String, leaseId As String, sessionId As String, flag As SyncFlag, offsetFile As Long, 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
文件的路径
- leaseId
- String
包含租约 ID 的字符串,当客户端获取对文件的租约时,其他客户端无法对文件进行编辑
- sessionId
- String
用于在服务器上轻松获取文件处理程序 (流) 的 UUID
- flag
- SyncFlag
在写入数据字节时传递 SyncFlag.METADATA 时传递 SyncFlag.METADATA 时,文件的元数据(如长度、修改后的即时)需要更新,以便与文件的实际数据保持一致。 传递 SyncFlag.METADATA GetFileStatus 和 ListStatus 后,返回一致数据。 无需追加更多数据、更新文件元数据、释放租约和关闭流时传递 SyncFlag.CLOSE
- offsetFile
- Int64
将追加数据的文件中的偏移量
- dataBytes
- Byte[]
要写入文件的字节数组
- offset
- Int32
字节数组中的偏移量
- length
- Int32
要从偏移量写入的字节数
- client
- AdlsClient
ADLS 客户端
- req
- RequestOptions
用于更改 Http 请求行为的选项
- resp
- OperationResponse
存储 Http 请求的响应/输出
- cancelToken
- CancellationToken
取消取消请求的 CancellationToken