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

BlockBlobClient.CommitBlockList 方法

定义

CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken)操作通过指定构成 Blob 的块 ID 列表来写入 Blob。 要写为 Blob 的一部分,块必须在Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)操作之前已成功写入服务器。 可以调用CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken)来更新 Blob,这样将仅上载已更改的块,然后一起提交新块和现有块。 为此,请指定是从提交的块列表或未提交的块列表提交块,还是提交块的最近上载版本,无论块可能属于哪个列表。 未在阻止列表中指定并永久删除的任何块。

有关详细信息,请参阅 放置阻止列表

public virtual Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo> CommitBlockList (System.Collections.Generic.IEnumerable<string> base64BlockIds, Azure.Storage.Blobs.Models.CommitBlockListOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member CommitBlockList : seq<string> * Azure.Storage.Blobs.Models.CommitBlockListOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>
override this.CommitBlockList : seq<string> * Azure.Storage.Blobs.Models.CommitBlockListOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>
Public Overridable Function CommitBlockList (base64BlockIds As IEnumerable(Of String), options As CommitBlockListOptions, Optional cancellationToken As CancellationToken = Nothing) As Response(Of BlobContentInfo)

参数

base64BlockIds
IEnumerable<String>

指定“未提交的 Base64 编码块 ID”,以指示 Blob 服务应仅搜索未提交的块列表来查找命名块。 如果在未提交的块列表中找不到该块,则不会将其作为 Blob 的一 RequestFailedException 部分写入,并且将引发 。

options
CommitBlockListOptions

可选参数。

cancellationToken
CancellationToken

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

返回

描述 Response<T> 更新的块 Blob 的状态的 。

注解

RequestFailedException如果失败,将引发 。

适用于