CloudAppendBlob.AppendBlockAsync 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í.
Sobrecargas
AppendBlockAsync(Stream, String)
Inicia una operación asincrónica para confirmar un nuevo bloque de datos al final del blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5 = default);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, Optional contentMD5 As String = Nothing) As Task(Of Long)
Parámetros
- contentMD5
- String
Valor hash opcional que se usa para garantizar la integridad transaccional. Puede ser null
o una cadena vacía.
Devoluciones
Objeto Task que representa la operación asincrónica.
- Atributos
Comentarios
Los clientes pueden enviar el encabezado Content-MD5 para una operación de bloque append determinada como medio para garantizar la integridad transaccional a través de la conexión. El contentMD5
parámetro permite a los clientes que ya tienen acceso a un valor MD5 calculado previamente para un intervalo de bytes determinado para proporcionarlo. Si la BlobRequestOptions.UseTransactionalMd5 propiedad se establece true
en y el contentMD5
parámetro se establece null
en , la biblioteca cliente calculará el valor MD5 internamente.
Se aplica a
AppendBlockAsync(Stream, String, CancellationToken)
Inicia una operación asincrónica para confirmar un nuevo bloque de datos al final del blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, cancellationToken As CancellationToken) As Task(Of Long)
Parámetros
- contentMD5
- String
Valor hash opcional que se usa para garantizar la integridad transaccional. Puede ser null
o una cadena vacía.
- cancellationToken
- CancellationToken
Un CancellationToken que se observará mientras se espera a que se complete la tarea.
Devoluciones
Objeto Task que representa la operación asincrónica.
- Atributos
Comentarios
Los clientes pueden enviar el encabezado Content-MD5 para una operación Put Block determinada como medio para garantizar la integridad transaccional a través de la conexión. El contentMD5
parámetro permite a los clientes que ya tienen acceso a un valor MD5 calculado previamente para un intervalo de bytes determinado para proporcionarlo. Si la BlobRequestOptions.UseTransactionalMd5 propiedad se establece true
en y el contentMD5
parámetro se establece null
en , la biblioteca cliente calculará el valor MD5 internamente.
Se aplica a
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext)
Inicia una operación asincrónica para confirmar un nuevo bloque de datos al final del blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task(Of Long)
Parámetros
- contentMD5
- String
Valor hash opcional que se usa para garantizar la integridad transaccional. Puede ser null
o una cadena vacía.
- accessCondition
- AccessCondition
Un objeto AccessCondition que representa la condición que debe cumplirse para continuar con la solicitud. Si es null
, no se usa ninguna condición.
- options
- BlobRequestOptions
Objeto BlobRequestOptions que especifica opciones adicionales para la solicitud.
- operationContext
- OperationContext
Objeto OperationContext que representa el contexto para la operación actual.
Devoluciones
Objeto Task que representa la operación asincrónica.
- Atributos
Comentarios
Los clientes pueden enviar el encabezado Content-MD5 para una operación de bloque append determinada como medio para garantizar la integridad transaccional a través de la conexión. El contentMD5
parámetro permite a los clientes que ya tienen acceso a un valor MD5 calculado previamente para un intervalo de bytes determinado para proporcionarlo. Si la BlobRequestOptions.UseTransactionalMd5 propiedad se establece true
en y el contentMD5
parámetro se establece null
en , la biblioteca cliente calculará el valor MD5 internamente.
Se aplica a
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Inicia una operación asincrónica para confirmar un nuevo bloque de datos al final del blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Long)
Parámetros
- contentMD5
- String
Valor hash opcional que se usa para garantizar la integridad transaccional. Puede ser null
o una cadena vacía.
- accessCondition
- AccessCondition
Un objeto AccessCondition que representa la condición que debe cumplirse para continuar con la solicitud. Si es null
, no se usa ninguna condición.
- options
- BlobRequestOptions
Objeto BlobRequestOptions que especifica opciones adicionales para la solicitud.
- operationContext
- OperationContext
Objeto OperationContext que representa el contexto para la operación actual.
- cancellationToken
- CancellationToken
Un CancellationToken que se observará mientras se espera a que se complete la tarea.
Devoluciones
Objeto Task que representa la operación asincrónica.
- Atributos
Comentarios
Los clientes pueden enviar el encabezado Content-MD5 para una operación de bloque append determinada como medio para garantizar la integridad transaccional a través de la conexión. El contentMD5
parámetro permite a los clientes que ya tienen acceso a un valor MD5 calculado previamente para un intervalo de bytes determinado para proporcionarlo. Si la BlobRequestOptions.UseTransactionalMd5 propiedad se establece true
en y el contentMD5
parámetro se establece null
en , la biblioteca cliente calculará el valor MD5 internamente.
Se aplica a
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)
Inicia una operación asincrónica para confirmar un nuevo bloque de datos al final del blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> progressHandler, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, progressHandler As IProgress(Of StorageProgress), cancellationToken As CancellationToken) As Task(Of Long)
Parámetros
- contentMD5
- String
Valor hash opcional que se usa para garantizar la integridad transaccional. Puede ser null
o una cadena vacía.
- accessCondition
- AccessCondition
Un objeto AccessCondition que representa la condición que debe cumplirse para continuar con la solicitud. Si es null
, no se usa ninguna condición.
- options
- BlobRequestOptions
Objeto BlobRequestOptions que especifica opciones adicionales para la solicitud.
- operationContext
- OperationContext
Objeto OperationContext que representa el contexto para la operación actual.
- progressHandler
- IProgress<StorageProgress>
Objeto IProgress<T> para controlar StorageProgress los mensajes.
- cancellationToken
- CancellationToken
Un CancellationToken que se observará mientras se espera a que se complete la tarea.
Devoluciones
Objeto Task que representa la operación asincrónica.
- Atributos
Comentarios
Los clientes pueden enviar el encabezado Content-MD5 para una operación de bloque append determinada como medio para garantizar la integridad transaccional a través de la conexión. El contentMD5
parámetro permite a los clientes que ya tienen acceso a un valor MD5 calculado previamente para un intervalo de bytes determinado para proporcionarlo. Si la BlobRequestOptions.UseTransactionalMd5 propiedad se establece true
en y el contentMD5
parámetro se establece null
en , la biblioteca cliente calculará el valor MD5 internamente.
Se aplica a
AppendBlockAsync(Uri, Int64, Int64, String, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Confirma un nuevo bloque de datos al final del blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (Uri sourceUri, long offset, long count, string sourceContentMd5, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition, Microsoft.Azure.Storage.AccessCondition destAccessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : Uri * int64 * int64 * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : Uri * int64 * int64 * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (sourceUri As Uri, offset As Long, count As Long, sourceContentMd5 As String, sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Long)
Parámetros
- offset
- Int64
Desplazamiento de bytes en el origen en el que se va a empezar a recuperar el contenido.
- count
- Int64
Número de bytes del origen que se va a devolver o null
para devolver todos los bytes al final del blob.
- sourceContentMd5
- String
Valor hash opcional que se usará para establecer la ContentMD5 propiedad en el blob. Puede ser null
o una cadena vacía.
- sourceAccessCondition
- AccessCondition
Objeto AccessCondition que representa las condiciones de acceso del blob de origen. Si es null
, no se usa ninguna condición.
- destAccessCondition
- AccessCondition
Objeto AccessCondition que representa las condiciones de acceso del blob de destino. Si es null
, no se usa ninguna condición.
- options
- BlobRequestOptions
Objeto BlobRequestOptions que especifica opciones adicionales para la solicitud.
- operationContext
- OperationContext
Objeto OperationContext que representa el contexto para la operación actual.
- cancellationToken
- CancellationToken
Un CancellationToken que se observará mientras se espera a que se complete la tarea.
Devoluciones
que Task representa una acción asincrónica.
- Atributos
Se aplica a
Azure SDK for .NET