CloudPageBlob.WritePagesAsync 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
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Inicia una operación asincrónica para escribir páginas en un blob en páginas.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WritePagesAsync (System.IO.Stream pageData, long startOffset, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum, 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 WritePagesAsync : System.IO.Stream * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WritePagesAsync : System.IO.Stream * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function WritePagesAsync (pageData As Stream, startOffset As Long, contentChecksum As Checksum, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task
Parámetros
- startOffset
- Int64
Desplazamiento en el que se va a comenzar a escribir, en bytes. El desplazamiento debe ser un múltiplo de 512.
- contentChecksum
- Checksum
Valor hash utilizado para garantizar la integridad transaccional. Puede ser null
o Checksum.None
- 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 los encabezados de suma de comprobación de contenido para una operación determinada como medio para garantizar la integridad transaccional a través de la conexión. El contentChecksum
parámetro permite a los clientes que ya tienen acceso a un valor de suma de comprobación calculado previamente para un intervalo de bytes determinado para proporcionarlo. Si las BlobRequestOptions.UseTransactionalMd5 propiedades o BlobRequestOptions.UseTransactionalCrc64 se establecen true
en y el parámetro de contenido correspondiente se establece null
en , la biblioteca cliente calculará internamente el valor de suma de comprobación.
Se aplica a
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext)
Inicia una operación asincrónica para escribir páginas en un blob en páginas.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WritePagesAsync (System.IO.Stream pageData, long startOffset, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member WritePagesAsync : System.IO.Stream * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
override this.WritePagesAsync : System.IO.Stream * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
Public Overridable Function WritePagesAsync (pageData As Stream, startOffset As Long, contentChecksum As Checksum, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task
Parámetros
- startOffset
- Int64
Desplazamiento en el que se va a comenzar a escribir, en bytes. El desplazamiento debe ser un múltiplo de 512.
- contentChecksum
- Checksum
Valor hash utilizado para garantizar la integridad transaccional. Puede ser null
o Checksum.None
- 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 los encabezados de suma de comprobación de contenido para una operación determinada como medio para garantizar la integridad transaccional a través de la conexión. El contentChecksum
parámetro permite a los clientes que ya tienen acceso a un valor de suma de comprobación calculado previamente para un intervalo de bytes determinado para proporcionarlo. Si las BlobRequestOptions.UseTransactionalMd5 propiedades o BlobRequestOptions.UseTransactionalCrc64 se establecen true
en y el parámetro de contenido correspondiente se establece null
en , la biblioteca cliente calculará internamente el valor de suma de comprobación.
Se aplica a
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)
Inicia una operación asincrónica para escribir páginas en un blob en páginas.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WritePagesAsync (System.IO.Stream pageData, long startOffset, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum, 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 WritePagesAsync : System.IO.Stream * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * 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
override this.WritePagesAsync : System.IO.Stream * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * 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
Public Overridable Function WritePagesAsync (pageData As Stream, startOffset As Long, contentChecksum As Checksum, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, progressHandler As IProgress(Of StorageProgress), cancellationToken As CancellationToken) As Task
Parámetros
- startOffset
- Int64
Desplazamiento en el que se va a comenzar a escribir, en bytes. El desplazamiento debe ser un múltiplo de 512.
- contentChecksum
- Checksum
Valor hash utilizado para garantizar la integridad transaccional. Puede ser null
o Checksum.None
- 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 los encabezados de suma de comprobación de contenido para una operación determinada como medio para garantizar la integridad transaccional a través de la conexión. El contentChecksum
parámetro permite a los clientes que ya tienen acceso a un valor de suma de comprobación calculado previamente para un intervalo de bytes determinado para proporcionarlo. Si las BlobRequestOptions.UseTransactionalMd5 propiedades o BlobRequestOptions.UseTransactionalCrc64 se establecen true
en y el parámetro de contenido correspondiente se establece null
en , la biblioteca cliente calculará internamente el valor de suma de comprobación.
Se aplica a
WritePagesAsync(Stream, Int64, Checksum)
Inicia una operación asincrónica para escribir páginas en un blob en páginas.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WritePagesAsync (System.IO.Stream pageData, long startOffset, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member WritePagesAsync : System.IO.Stream * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum -> System.Threading.Tasks.Task
override this.WritePagesAsync : System.IO.Stream * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum -> System.Threading.Tasks.Task
Public Overridable Function WritePagesAsync (pageData As Stream, startOffset As Long, contentChecksum As Checksum) As Task
Parámetros
- startOffset
- Int64
Desplazamiento en el que se va a comenzar a escribir, en bytes. El desplazamiento debe ser un múltiplo de 512.
- contentChecksum
- Checksum
Valor hash opcional que se usa para garantizar la integridad transaccional. Puede ser null
o Checksum.None
Devoluciones
Objeto Task que representa la operación asincrónica.
- Atributos
Comentarios
Los clientes pueden enviar los encabezados de suma de comprobación de contenido para una operación determinada como medio para garantizar la integridad transaccional a través de la conexión. El contentChecksum
parámetro permite a los clientes que ya tienen acceso a un valor de suma de comprobación calculado previamente para un intervalo de bytes determinado para proporcionarlo. Si las BlobRequestOptions.UseTransactionalMd5 propiedades o BlobRequestOptions.UseTransactionalCrc64 se establecen true
en y el parámetro de contenido correspondiente se establece null
en , la biblioteca cliente calculará internamente el valor de suma de comprobación.
Se aplica a
WritePagesAsync(Stream, Int64, Checksum, CancellationToken)
Inicia una operación asincrónica para escribir páginas en un blob en páginas.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WritePagesAsync (System.IO.Stream pageData, long startOffset, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member WritePagesAsync : System.IO.Stream * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WritePagesAsync : System.IO.Stream * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function WritePagesAsync (pageData As Stream, startOffset As Long, contentChecksum As Checksum, cancellationToken As CancellationToken) As Task
Parámetros
- startOffset
- Int64
Desplazamiento en el que se va a comenzar a escribir, en bytes. El desplazamiento debe ser un múltiplo de 512.
- contentChecksum
- Checksum
Valor hash utilizado para garantizar la integridad transaccional. Puede ser null
o Checksum.None
- 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 los encabezados de suma de comprobación de contenido para una operación determinada como medio para garantizar la integridad transaccional a través de la conexión. El contentChecksum
parámetro permite a los clientes que ya tienen acceso a un valor de suma de comprobación calculado previamente para un intervalo de bytes determinado para proporcionarlo. Si las BlobRequestOptions.UseTransactionalMd5 propiedades o BlobRequestOptions.UseTransactionalCrc64 se establecen true
en y el parámetro de contenido correspondiente se establece null
en , la biblioteca cliente calculará internamente el valor de suma de comprobación.
Se aplica a
WritePagesAsync(Uri, Int64, Int64, Int64, Checksum, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Inicia una operación asincrónica para escribir páginas en un blob en páginas.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WritePagesAsync (Uri sourceUri, long offset, long count, long startOffset, Microsoft.Azure.Storage.Shared.Protocol.Checksum sourceContentChecksum, 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 WritePagesAsync : Uri * int64 * int64 * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WritePagesAsync : Uri * int64 * int64 * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function WritePagesAsync (sourceUri As Uri, offset As Long, count As Long, startOffset As Long, sourceContentChecksum As Checksum, sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task
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 hasta el final del blob.
- startOffset
- Int64
Desplazamiento en el que se va a comenzar a escribir, en bytes. El desplazamiento debe ser un múltiplo de 512.
- sourceContentChecksum
- Checksum
- 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
Objeto Task que representa la operación asincrónica.
- Atributos
Se aplica a
Azure SDK for .NET