CloudPageBlob.WritePagesAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Inicia uma operação assíncrona para gravar páginas em um blob de 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
O deslocamento no qual a gravação deve ser iniciada, em bytes. O deslocamento deve ser um múltiplo de 512.
- contentChecksum
- Checksum
Um valor de hash usado para garantir a integridade transacional. Pode ser null
ou Checksum.None
- accessCondition
- AccessCondition
Um objeto AccessCondition que representa a condição que deve ser atendida para que a solicitação continue. Se for null
, nenhuma condição é usada.
- options
- BlobRequestOptions
Um objeto BlobRequestOptions que especifica opções adicionais para a solicitação.
- operationContext
- OperationContext
Um objeto OperationContext que representa o contexto da operação atual.
- cancellationToken
- CancellationToken
Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Comentários
Os clientes podem enviar os cabeçalhos de soma de verificação de conteúdo para uma determinada operação como um meio para garantir a integridade transacional pela transmissão. O contentChecksum
parâmetro permite que os clientes que já têm acesso a um valor de soma de verificação pré-computado para um determinado intervalo de bytes forneçam a ele. Se as BlobRequestOptions.UseTransactionalMd5 propriedades ou BlobRequestOptions.UseTransactionalCrc64 estiverem definidas como true
e o parâmetro de conteúdo correspondente estiver definido como null
, a biblioteca de clientes calculará o valor da soma de verificação internamente.
Aplica-se a
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext)
Inicia uma operação assíncrona para gravar páginas em um blob de 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
O deslocamento no qual a gravação deve ser iniciada, em bytes. O deslocamento deve ser um múltiplo de 512.
- contentChecksum
- Checksum
Um valor de hash usado para garantir a integridade transacional. Pode ser null
ou Checksum.None
- accessCondition
- AccessCondition
Um objeto AccessCondition que representa a condição que deve ser atendida para que a solicitação continue. Se for null
, nenhuma condição é usada.
- options
- BlobRequestOptions
Um objeto BlobRequestOptions que especifica opções adicionais para a solicitação.
- operationContext
- OperationContext
Um objeto OperationContext que representa o contexto da operação atual.
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Comentários
Os clientes podem enviar os cabeçalhos de soma de verificação de conteúdo para uma determinada operação como um meio para garantir a integridade transacional pela transmissão. O contentChecksum
parâmetro permite que os clientes que já têm acesso a um valor de soma de verificação pré-computado para um determinado intervalo de bytes forneçam a ele. Se as BlobRequestOptions.UseTransactionalMd5 propriedades ou BlobRequestOptions.UseTransactionalCrc64 estiverem definidas como true
e o parâmetro de conteúdo correspondente estiver definido como null
, a biblioteca de clientes calculará o valor da soma de verificação internamente.
Aplica-se a
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)
Inicia uma operação assíncrona para gravar páginas em um blob de 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
O deslocamento no qual a gravação deve ser iniciada, em bytes. O deslocamento deve ser um múltiplo de 512.
- contentChecksum
- Checksum
Um valor de hash usado para garantir a integridade transacional. Pode ser null
ou Checksum.None
- accessCondition
- AccessCondition
Um objeto AccessCondition que representa a condição que deve ser atendida para que a solicitação continue. Se for null
, nenhuma condição é usada.
- options
- BlobRequestOptions
Um objeto BlobRequestOptions que especifica opções adicionais para a solicitação.
- operationContext
- OperationContext
Um objeto OperationContext que representa o contexto da operação atual.
- progressHandler
- IProgress<StorageProgress>
Um IProgress<T> objeto para manipular StorageProgress mensagens.
- cancellationToken
- CancellationToken
Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Comentários
Os clientes podem enviar os cabeçalhos de soma de verificação de conteúdo para uma determinada operação como um meio para garantir a integridade transacional pela transmissão. O contentChecksum
parâmetro permite que os clientes que já têm acesso a um valor de soma de verificação pré-computado para um determinado intervalo de bytes forneçam a ele. Se as BlobRequestOptions.UseTransactionalMd5 propriedades ou BlobRequestOptions.UseTransactionalCrc64 estiverem definidas como true
e o parâmetro de conteúdo correspondente estiver definido como null
, a biblioteca de clientes calculará o valor da soma de verificação internamente.
Aplica-se a
WritePagesAsync(Stream, Int64, Checksum)
Inicia uma operação assíncrona para gravar páginas em um blob de 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
O deslocamento no qual a gravação deve ser iniciada, em bytes. O deslocamento deve ser um múltiplo de 512.
- contentChecksum
- Checksum
Um valor de hash opcional usado para garantir a integridade transacional. Pode ser null
ou Checksum.None
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Comentários
Os clientes podem enviar os cabeçalhos de soma de verificação de conteúdo para uma determinada operação como um meio para garantir a integridade transacional pela transmissão. O contentChecksum
parâmetro permite que os clientes que já têm acesso a um valor de soma de verificação pré-computado para um determinado intervalo de bytes forneçam a ele. Se as BlobRequestOptions.UseTransactionalMd5 propriedades ou BlobRequestOptions.UseTransactionalCrc64 estiverem definidas como true
e o parâmetro de conteúdo correspondente estiver definido como null
, a biblioteca de clientes calculará o valor da soma de verificação internamente.
Aplica-se a
WritePagesAsync(Stream, Int64, Checksum, CancellationToken)
Inicia uma operação assíncrona para gravar páginas em um blob de 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
O deslocamento no qual a gravação deve ser iniciada, em bytes. O deslocamento deve ser um múltiplo de 512.
- contentChecksum
- Checksum
Um valor de hash usado para garantir a integridade transacional. Pode ser null
ou Checksum.None
- cancellationToken
- CancellationToken
Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Comentários
Os clientes podem enviar os cabeçalhos de soma de verificação de conteúdo para uma determinada operação como um meio para garantir a integridade transacional pela transmissão. O contentChecksum
parâmetro permite que os clientes que já têm acesso a um valor de soma de verificação pré-computado para um determinado intervalo de bytes forneçam a ele. Se as BlobRequestOptions.UseTransactionalMd5 propriedades ou BlobRequestOptions.UseTransactionalCrc64 estiverem definidas como true
e o parâmetro de conteúdo correspondente estiver definido como null
, a biblioteca de clientes calculará o valor da soma de verificação internamente.
Aplica-se a
WritePagesAsync(Uri, Int64, Int64, Int64, Checksum, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Inicia uma operação assíncrona para gravar páginas em um blob de 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
O deslocamento de bytes na origem na qual começar a recuperar conteúdo.
- count
- Int64
O número de bytes da origem a ser retornado ou null
para retornar todos os bytes até o final do blob.
- startOffset
- Int64
O deslocamento no qual a gravação deve ser iniciada, em bytes. O deslocamento deve ser um múltiplo de 512.
- sourceContentChecksum
- Checksum
- sourceAccessCondition
- AccessCondition
Um AccessCondition objeto que representa as condições de acesso para o blob de origem. Se for null
, nenhuma condição é usada.
- destAccessCondition
- AccessCondition
Um AccessCondition objeto que representa as condições de acesso para o blob de destino. Se for null
, nenhuma condição é usada.
- options
- BlobRequestOptions
Um objeto BlobRequestOptions que especifica opções adicionais para a solicitação.
- operationContext
- OperationContext
Um objeto OperationContext que representa o contexto da operação atual.
- cancellationToken
- CancellationToken
Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Aplica-se a
Azure SDK for .NET
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários