CloudPageBlob.WritePagesAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Lance une opération asynchrone pour écrire des pages dans un objet blob de pages.
[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
Paramètres
- startOffset
- Int64
Décalage, en octets, à partir duquel commencer l'écriture. Le décalage doit être un multiple de 512.
- contentChecksum
- Checksum
Valeur de hachage utilisée pour garantir l’intégrité transactionnelle. Peut être null
ou Somme de contrôle.None
- accessCondition
- AccessCondition
Objet AccessCondition qui représente la condition qui doit être remplie pour que la demande continue. Si la valeur est null
, aucune condition n'est utilisée.
- options
- BlobRequestOptions
Objet BlobRequestOptions qui spécifie les options supplémentaires de la demande.
- operationContext
- OperationContext
Objet OperationContext qui représente le contexte de l'opération actuelle.
- cancellationToken
- CancellationToken
CancellationToken à observer en attendant qu'une tâche se termine.
Retours
Objet Task qui représente l’opération asynchrone.
- Attributs
Remarques
Les clients peuvent envoyer les en-têtes de somme de contrôle de contenu pour une opération donnée afin de garantir l’intégrité transactionnelle sur le réseau. Le contentChecksum
paramètre permet aux clients qui ont déjà accès à une valeur de somme de contrôle prédéfinie pour une plage d’octets donnée de la fournir. Si les BlobRequestOptions.UseTransactionalMd5 propriétés ou BlobRequestOptions.UseTransactionalCrc64 ont la valeur true
et que le paramètre de contenu correspondant a la valeur null
, la bibliothèque cliente calcule la valeur de la somme de contrôle en interne.
S’applique à
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext)
Lance une opération asynchrone pour écrire des pages dans un objet blob de pages.
[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
Paramètres
- startOffset
- Int64
Décalage, en octets, à partir duquel commencer l'écriture. Le décalage doit être un multiple de 512.
- contentChecksum
- Checksum
Valeur de hachage utilisée pour garantir l’intégrité transactionnelle. Peut être null
ou Somme de contrôle.None
- accessCondition
- AccessCondition
Objet AccessCondition qui représente la condition qui doit être remplie pour que la demande continue. Si la valeur est null
, aucune condition n'est utilisée.
- options
- BlobRequestOptions
Objet BlobRequestOptions qui spécifie les options supplémentaires de la demande.
- operationContext
- OperationContext
Objet OperationContext qui représente le contexte de l'opération actuelle.
Retours
Objet Task qui représente l’opération asynchrone.
- Attributs
Remarques
Les clients peuvent envoyer les en-têtes de somme de contrôle de contenu pour une opération donnée afin de garantir l’intégrité transactionnelle sur le réseau. Le contentChecksum
paramètre permet aux clients qui ont déjà accès à une valeur de somme de contrôle prédéfinie pour une plage d’octets donnée de la fournir. Si les BlobRequestOptions.UseTransactionalMd5 propriétés ou BlobRequestOptions.UseTransactionalCrc64 ont la valeur true
et que le paramètre de contenu correspondant a la valeur null
, la bibliothèque cliente calcule la valeur de la somme de contrôle en interne.
S’applique à
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)
Lance une opération asynchrone pour écrire des pages dans un objet blob de pages.
[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
Paramètres
- startOffset
- Int64
Décalage, en octets, à partir duquel commencer l'écriture. Le décalage doit être un multiple de 512.
- contentChecksum
- Checksum
Valeur de hachage utilisée pour garantir l’intégrité transactionnelle. Peut être null
ou Somme de contrôle.None
- accessCondition
- AccessCondition
Objet AccessCondition qui représente la condition qui doit être remplie pour que la demande continue. Si la valeur est null
, aucune condition n'est utilisée.
- options
- BlobRequestOptions
Objet BlobRequestOptions qui spécifie les options supplémentaires de la demande.
- operationContext
- OperationContext
Objet OperationContext qui représente le contexte de l'opération actuelle.
- progressHandler
- IProgress<StorageProgress>
Objet IProgress<T> pour gérer les StorageProgress messages.
- cancellationToken
- CancellationToken
CancellationToken à observer en attendant qu'une tâche se termine.
Retours
Objet Task qui représente l’opération asynchrone.
- Attributs
Remarques
Les clients peuvent envoyer les en-têtes de somme de contrôle de contenu pour une opération donnée afin de garantir l’intégrité transactionnelle sur le réseau. Le contentChecksum
paramètre permet aux clients qui ont déjà accès à une valeur de somme de contrôle prédéfinie pour une plage d’octets donnée de la fournir. Si les BlobRequestOptions.UseTransactionalMd5 propriétés ou BlobRequestOptions.UseTransactionalCrc64 ont la valeur true
et que le paramètre de contenu correspondant a la valeur null
, la bibliothèque cliente calcule la valeur de la somme de contrôle en interne.
S’applique à
WritePagesAsync(Stream, Int64, Checksum)
Lance une opération asynchrone pour écrire des pages dans un objet blob de pages.
[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
Paramètres
- startOffset
- Int64
Décalage, en octets, à partir duquel commencer l'écriture. Le décalage doit être un multiple de 512.
- contentChecksum
- Checksum
Valeur de hachage facultative utilisée pour garantir l’intégrité transactionnelle. Peut être null
ou Somme de contrôle.None
Retours
Objet Task qui représente l’opération asynchrone.
- Attributs
Remarques
Les clients peuvent envoyer les en-têtes de somme de contrôle de contenu pour une opération donnée afin de garantir l’intégrité transactionnelle sur le réseau. Le contentChecksum
paramètre permet aux clients qui ont déjà accès à une valeur de somme de contrôle prédéfinie pour une plage d’octets donnée de la fournir. Si les BlobRequestOptions.UseTransactionalMd5 propriétés ou BlobRequestOptions.UseTransactionalCrc64 ont la valeur true
et que le paramètre de contenu correspondant a la valeur null
, la bibliothèque cliente calcule la valeur de la somme de contrôle en interne.
S’applique à
WritePagesAsync(Stream, Int64, Checksum, CancellationToken)
Lance une opération asynchrone pour écrire des pages dans un objet blob de pages.
[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
Paramètres
- startOffset
- Int64
Décalage, en octets, à partir duquel commencer l'écriture. Le décalage doit être un multiple de 512.
- contentChecksum
- Checksum
Valeur de hachage utilisée pour garantir l’intégrité transactionnelle. Peut être null
ou Somme de contrôle.None
- cancellationToken
- CancellationToken
CancellationToken à observer en attendant qu'une tâche se termine.
Retours
Objet Task qui représente l’opération asynchrone.
- Attributs
Remarques
Les clients peuvent envoyer les en-têtes de somme de contrôle de contenu pour une opération donnée afin de garantir l’intégrité transactionnelle sur le réseau. Le contentChecksum
paramètre permet aux clients qui ont déjà accès à une valeur de somme de contrôle prédéfinie pour une plage d’octets donnée de la fournir. Si les BlobRequestOptions.UseTransactionalMd5 propriétés ou BlobRequestOptions.UseTransactionalCrc64 ont la valeur true
et que le paramètre de contenu correspondant a la valeur null
, la bibliothèque cliente calcule la valeur de la somme de contrôle en interne.
S’applique à
WritePagesAsync(Uri, Int64, Int64, Int64, Checksum, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Lance une opération asynchrone pour écrire des pages dans un objet blob de pages.
[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
Paramètres
- offset
- Int64
Décalage d’octet dans la source à laquelle commencer la récupération du contenu.
- count
- Int64
Nombre d’octets de la source à retourner, ou null
pour retourner tous les octets jusqu’à la fin de l’objet blob.
- startOffset
- Int64
Décalage, en octets, à partir duquel commencer l'écriture. Le décalage doit être un multiple de 512.
- sourceContentChecksum
- Checksum
- sourceAccessCondition
- AccessCondition
Objet AccessCondition qui représente les conditions d’accès pour l’objet blob source. Si la valeur est null
, aucune condition n'est utilisée.
- destAccessCondition
- AccessCondition
Objet AccessCondition qui représente les conditions d’accès pour l’objet blob de destination. Si la valeur est null
, aucune condition n'est utilisée.
- options
- BlobRequestOptions
Objet BlobRequestOptions qui spécifie les options supplémentaires de la demande.
- operationContext
- OperationContext
Objet OperationContext qui représente le contexte de l'opération actuelle.
- cancellationToken
- CancellationToken
CancellationToken à observer en attendant qu'une tâche se termine.
Retours
Objet Task qui représente l’opération asynchrone.
- Attributs
S’applique à
Azure SDK for .NET