BlockBlobClient.CommitBlockListAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
que Response<T> describe el estado del blob en bloques actualizado.
Comentarios
RequestFailedException Se producirá una excepción si se produce un error.
Se aplica a
Azure SDK for .NET