BlockBlobClient.CommitBlockList Methode

Definition

Namespace:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Paket:

Azure.Storage.Blobs v12.20.0

Quelle:

BlockBlobClient.cs

Der CommitBlockList(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 CommitBlockList(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 Blockliste platzieren.

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)

Parameter

base64BlockIds

IEnumerable<String>

Geben Sie die Base64-codierten Block-IDs ohne Bindung an, um anzugeben, dass der Blobdienst nur die nicht festgeschriebene Blockliste nach den benannten Blöcken durchsuchen soll. Wenn der Block nicht in der Nicht-Blockliste 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

Response<BlobContentInfo>

Ein Response<T> , der den Zustand des aktualisierten Blockblobs beschreibt.

Hinweise

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