你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
DataLakeFileClient.Append 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
该 Append(Stream, Int64, DataLakeFileAppendOptions, CancellationToken) 操作上传要追加到文件的数据。 数据只能追加到文件。 若要将以前上传的数据应用于文件,请调用 Flush Data。 追加当前限制为每个请求 4000 MB。 若要同时上传所有大型文件,请考虑使用 Upload(Stream)。
有关详细信息,请参阅 更新路径。
public virtual Azure.Response Append (System.IO.Stream content, long offset, Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions options = default, System.Threading.CancellationToken cancellationToken = default);
abstract member Append : System.IO.Stream * int64 * Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions * System.Threading.CancellationToken -> Azure.Response
override this.Append : System.IO.Stream * int64 * Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions * System.Threading.CancellationToken -> Azure.Response
Public Overridable Function Append (content As Stream, offset As Long, Optional options As DataLakeFileAppendOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response
参数
- offset
- Int64
此参数允许调用方并行上传数据,并控制数据追加到文件的顺序。 上传要追加到文件的数据以及将以前上传的数据刷新到该文件时,都需要它。 值必须是要追加数据的位置。 上传的数据不会立即刷新或写入文件。 若要刷新,以前上传的数据必须是连续的,必须指定位置参数,并且必须在写入所有数据后等于文件的长度,并且请求中不得包含请求实体正文。
- options
- DataLakeFileAppendOptions
可选参数。
- cancellationToken
- CancellationToken
可选 CancellationToken ,用于传播应取消操作的通知。
返回
描述 Response 已更新文件的状态的 。
注解
RequestFailedException如果发生故障,将引发 。