BlockBlobClient.CommitBlockListAsync メソッド

定義

名前空間:

Azure.Storage.Blobs.Specialized

アセンブリ:

Azure.Storage.Blobs.dll

パッケージ:

Azure.Storage.Blobs v12.20.0

ソース:

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エラーが発生すると、 がスローされます。