你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
BlockBlobClient.CommitBlockList 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
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如果失败,将引发 。