BlockBlobClient.CommitBlockListAsync Método

Definición

Espacio de nombres:

Azure.Storage.Blobs.Specialized

Ensamblado:

Azure.Storage.Blobs.dll

Paquete:

Azure.Storage.Blobs v12.20.0

Source:

BlockBlobClient.cs

La operación CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) escribe un blob especificando la lista de identificadores de bloque que conforman el blob. Para poder escribirlo como parte de un blob, un bloque se debe haber escrito correctamente en el servidor en una operación 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) anterior. Puede llamar a CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) para actualizar un blob cargando solo los bloques que han cambiado y luego confirmando a la vez los bloques nuevos y los existentes. Puede hacerlo especificando si se debe confirmar un bloque de la lista de bloques confirmados o de la lista de bloques sin confirmar, o bien confirmar la versión del bloque que se ha cargado en último lugar, independientemente de la lista a la que pertenezca. Los bloques no especificados en la lista de bloques y eliminados permanentemente.

Para obtener más información, vea Colocar lista de bloqueos.

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

Parámetros

base64BlockIds

IEnumerable<String>

Especifique los identificadores de bloque codificados en Base64 no confirmados para indicar que blob service debe buscar solo en la lista de bloques sin confirmar para los bloques con nombre. Si el bloque no se encuentra en la lista de bloques sin confirmar, no se escribirá como parte del blob y se producirá una RequestFailedException excepción .

options

CommitBlockListOptions

Parámetros opcionales.

cancellationToken

CancellationToken

Opcional CancellationToken para propagar las notificaciones que debe cancelarse la operación.

Devoluciones

Task<Response<BlobContentInfo>>

que Response<T> describe el estado del blob en bloques actualizado.

Comentarios

RequestFailedException Se producirá una excepción si se produce un error.