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

DataLakeFileClient.AppendAsync 方法

定义

命名空间:

Azure.Storage.Files.DataLake

程序集:

Azure.Storage.Files.DataLake.dll

包:

Azure.Storage.Files.DataLake v12.17.1

Source:

DataLakeFileClient.cs

该 AppendAsync(Stream, Int64, DataLakeFileAppendOptions, CancellationToken) 操作上传要追加到文件的数据。 数据只能追加到文件。 若要将经常上传的数据应用于文件，请调用 Flush Data。 追加当前限制为每个请求 4000 MB。 若要一次性上传大文件，请考虑使用 UploadAsync(Stream)。

有关详细信息，请参阅 更新路径。

public virtual System.Threading.Tasks.Task<Azure.Response> AppendAsync (System.IO.Stream content, long offset, Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions options = default, System.Threading.CancellationToken cancellationToken = default);

abstract member AppendAsync : System.IO.Stream * int64 * Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
override this.AppendAsync : System.IO.Stream * int64 * Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function AppendAsync (content As Stream, offset As Long, Optional options As DataLakeFileAppendOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response)

参数

content

Stream

包含 Stream 要上传的内容的 。

offset

Int64

此参数允许调用方并行上传数据，并控制数据追加到文件的顺序。 上传要追加到文件的数据时，以及将以前上传的数据刷新到文件时，这是必需的。 该值必须是要追加数据的位置。 上传的数据不会立即刷新或写入文件。 若要刷新，以前上传的数据必须是连续的，必须指定 position 参数，并且必须在写入所有数据后等于文件的长度，并且请求中不得包含请求实体正文。

options

DataLakeFileAppendOptions

可选参数。

cancellationToken

CancellationToken

可选 CancellationToken ，用于传播应取消操作的通知。

返回

Task<Response>

描述 Response 已更新文件的状态的 。

注解

RequestFailedException如果失败，将引发 。