BlockBlobClient.CommitBlockListAsync Methode

Definition

Namespace:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Paket:

Azure.Storage.Blobs v12.20.0

Quelle:

BlockBlobClient.cs

Der CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken)-Vorgang schreibt ein BLOB, indem die Liste der Block-IDs angegeben wird, aus denen sich das BLOB zusammensetzt. Wenn ein Block als Teil eines BLOB geschrieben werden soll, muss er zuvor erfolgreich in einem 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)-Vorgang auf den Server geschrieben worden sein. Sie können CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) aufrufen, um ein BLOB zu aktualisieren, indem Sie nur die Blöcke mit Änderungen hochladen und anschließend für die neuen und vorhandenen Blöcke einen Commit ausführen. Dies erreichen Sie, indem Sie angeben, ob für einen Block aus der Liste der Blöcke mit ausgeführtem Commit oder der Liste der Blöcke ohne ausgeführten Commit ein Commit ausgeführt werden soll, oder ob für die zuletzt hochgeladene Version des Blocks ein Commit ausgeführt werden soll, je nachdem, in welcher Liste der Block enthalten ist. Alle Blöcke, die nicht in der Blockliste angegeben und endgültig gelöscht wurden.

Weitere Informationen finden Sie unter Liste "Blockieren" einfügen.

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))

Parameter

base64BlockIds

IEnumerable<String>

Geben Sie die base64-codierten Block-IDs ohne Commit an, um anzugeben, dass der Blobdienst nur die Blockliste ohne Commit nach den benannten Blöcken durchsuchen soll. Wenn der Block nicht in der Blockliste ohne Commit gefunden wird, wird er nicht als Teil des Blobs geschrieben, und ein RequestFailedException wird ausgelöst.

options

CommitBlockListOptions

Optionale Parameter.

cancellationToken

CancellationToken

Optional CancellationToken zur Weitergabe von Benachrichtigungen, dass der Vorgang abgebrochen werden soll.

Gibt zurück

Task<Response<BlobContentInfo>>

Eine Response<T> , die den Status des aktualisierten Blockblobs beschreibt.

Hinweise

Ein RequestFailedException wird ausgelöst, wenn ein Fehler auftritt.