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

BlockBlobClient.CommitBlockListAsync 方法

定义

命名空间:

Azure.Storage.Blobs.Specialized

程序集:

Azure.Storage.Blobs.dll

包:

Azure.Storage.Blobs v12.20.0

Source:

BlockBlobClient.cs

CommitBlockListAsync(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)操作之前已成功写入服务器。 可以调用CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken)来更新 Blob，这样将仅上载已更改的块，然后一起提交新块和现有块。 为此，请指定是从提交的块列表或未提交的块列表提交块，还是提交块的最近上载版本，无论块可能属于哪个列表。 未在阻止列表中指定并永久删除的任何块。

有关详细信息，请参阅 放置块列表。

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>> CommitBlockListAsync (System.Collections.Generic.IEnumerable<string> base64BlockIds, Azure.Storage.Blobs.Models.CommitBlockListOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member CommitBlockListAsync : seq<string> * Azure.Storage.Blobs.Models.CommitBlockListOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>>
override this.CommitBlockListAsync : seq<string> * Azure.Storage.Blobs.Models.CommitBlockListOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>>

Public Overridable Function CommitBlockListAsync (base64BlockIds As IEnumerable(Of String), options As CommitBlockListOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of BlobContentInfo))

参数

base64BlockIds

IEnumerable<String>

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

options

CommitBlockListOptions

可选参数。

cancellationToken

CancellationToken

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

返回

Task<Response<BlobContentInfo>>

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

注解

RequestFailedException如果发生故障，将引发 。