BlockBlobClient.CommitBlockListAsync Méthode

Définition

Espace de noms:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Paquet:

Azure.Storage.Blobs v12.19.1

Source:

BlockBlobClient.cs

L'opération CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) écrit un objet blob en spécifiant la liste des ID de bloc qui le composent. Afin d'être écrit dans le cadre d'un objet blob, un bloc doit avoir été correctement écrit sur le serveur dans une opération 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) précédente. Vous pouvez appeler CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) pour mettre à jour un objet blob en téléchargeant uniquement les blocs qui ont changé, puis en validant les blocs nouveaux et existants. Vous pouvez faire cela en spécifiant si un bloc doit être validé à partir de la liste de blocs validés ou de la liste de blocs non validés, ou si la version du bloc téléchargée en dernier doit être validée en indiquant la liste auquel le bloc appartient. Tous les blocs non spécifiés dans la liste de blocs et supprimés définitivement.

Pour plus d'informations, consultez la rubrique Mettre la liste de blocs.

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

Paramètres

base64BlockIds

IEnumerable<String>

Spécifiez les ID de blocs encodés en base64 non validés pour indiquer que le service d’objets blob doit rechercher uniquement les blocs nommés dans la liste de blocs non validés. Si le bloc est introuvable dans la liste de blocs non validée, il n’est pas écrit dans le cadre de l’objet blob et un RequestFailedException est levée.

options

CommitBlockListOptions

Paramètres facultatifs.

cancellationToken

CancellationToken

Facultatif CancellationToken pour propager des notifications indiquant que l’opération doit être annulée.

Retours

Task<Response<BlobContentInfo>>

Response<T> décrivant l’état de l’objet blob de blocs mis à jour.

Remarques

Un RequestFailedException sera levée en cas d’échec.