你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
CloudPageBlob.WritePagesAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
启动异步操作以将页写入页 Blob。
[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.TaskPublic 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参数
- startOffset
- Int64
开始写入的偏移量（以字节为单位）。 偏移量必须是 512 的倍数。
- contentChecksum
- Checksum
用于确保事务完整性的哈希值。 可以是 null 或 校验和。None
- accessCondition
- AccessCondition
一个 AccessCondition 对象，表示继续处理请求而必须满足的条件。 如果为 null，则不使用任何条件。
- options
- BlobRequestOptions
一个 BlobRequestOptions 对象，它指定请求的其他选项。
- operationContext
- OperationContext
一个 OperationContext 对象，它一个表示当前操作的上下文。
- cancellationToken
- CancellationToken
等待任务完成期间要观察的 CancellationToken。
返回
表示异步操作的 Task 对象。
- 属性
注解
客户端可以发送给定操作的内容校验和标头，以确保通过网络实现事务完整性。 参数 contentChecksum 允许已有权访问给定字节范围的预计算校验和值的客户端提供该值。 BlobRequestOptions.UseTransactionalMd5如果 或 BlobRequestOptions.UseTransactionalCrc64 属性设置为 true ，并且相应的内容参数设置为 null，则客户端库将在内部计算校验和值。
适用于
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext)
启动异步操作以将页写入页 Blob。
[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.TaskPublic Overridable Function WritePagesAsync (pageData As Stream, startOffset As Long, contentChecksum As Checksum, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task参数
- startOffset
- Int64
开始写入的偏移量（以字节为单位）。 偏移量必须是 512 的倍数。
- contentChecksum
- Checksum
用于确保事务完整性的哈希值。 可以是 null 或 校验和。None
- accessCondition
- AccessCondition
一个 AccessCondition 对象，表示继续处理请求而必须满足的条件。 如果为 null，则不使用任何条件。
- options
- BlobRequestOptions
一个 BlobRequestOptions 对象，它指定请求的其他选项。
- operationContext
- OperationContext
一个 OperationContext 对象，它一个表示当前操作的上下文。
返回
表示异步操作的 Task 对象。
- 属性
注解
客户端可以发送给定操作的内容校验和标头，以确保通过网络实现事务完整性。 参数 contentChecksum 允许已有权访问给定字节范围的预计算校验和值的客户端提供该值。 BlobRequestOptions.UseTransactionalMd5如果 或 BlobRequestOptions.UseTransactionalCrc64 属性设置为 true ，并且相应的内容参数设置为 null，则客户端库将在内部计算校验和值。
适用于
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)
启动异步操作以将页写入页 Blob。
[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.TaskPublic 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参数
- startOffset
- Int64
开始写入的偏移量（以字节为单位）。 偏移量必须是 512 的倍数。
- contentChecksum
- Checksum
用于确保事务完整性的哈希值。 可以是 null 或 校验和。None
- accessCondition
- AccessCondition
一个 AccessCondition 对象，表示继续处理请求而必须满足的条件。 如果为 null，则不使用任何条件。
- options
- BlobRequestOptions
一个 BlobRequestOptions 对象，它指定请求的其他选项。
- operationContext
- OperationContext
一个 OperationContext 对象，它一个表示当前操作的上下文。
- progressHandler
- IProgress<StorageProgress>
用于 IProgress<T> 处理 StorageProgress 消息的 对象。
- cancellationToken
- CancellationToken
等待任务完成期间要观察的 CancellationToken。
返回
表示异步操作的 Task 对象。
- 属性
注解
客户端可以发送给定操作的内容校验和标头，以确保通过网络实现事务完整性。 参数 contentChecksum 允许已有权访问给定字节范围的预计算校验和值的客户端提供该值。 BlobRequestOptions.UseTransactionalMd5如果 或 BlobRequestOptions.UseTransactionalCrc64 属性设置为 true ，并且相应的内容参数设置为 null，则客户端库将在内部计算校验和值。
适用于
WritePagesAsync(Stream, Int64, Checksum)
启动异步操作以将页写入页 Blob。
[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.TaskPublic Overridable Function WritePagesAsync (pageData As Stream, startOffset As Long, contentChecksum As Checksum) As Task参数
- startOffset
- Int64
开始写入的偏移量（以字节为单位）。 偏移量必须是 512 的倍数。
- contentChecksum
- Checksum
用于确保事务完整性的可选哈希值。 可以是 null 或 校验和。None
返回
表示异步操作的 Task 对象。
- 属性
注解
客户端可以发送给定操作的内容校验和标头，以确保通过网络实现事务完整性。 参数 contentChecksum 允许已有权访问给定字节范围的预计算校验和值的客户端提供该值。 BlobRequestOptions.UseTransactionalMd5如果 或 BlobRequestOptions.UseTransactionalCrc64 属性设置为 true ，并且相应的内容参数设置为 null，则客户端库将在内部计算校验和值。
适用于
WritePagesAsync(Stream, Int64, Checksum, CancellationToken)
启动异步操作以将页写入页 Blob。
[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.TaskPublic Overridable Function WritePagesAsync (pageData As Stream, startOffset As Long, contentChecksum As Checksum, cancellationToken As CancellationToken) As Task参数
- startOffset
- Int64
开始写入的偏移量（以字节为单位）。 偏移量必须是 512 的倍数。
- contentChecksum
- Checksum
用于确保事务完整性的哈希值。 可以是 null 或 校验和。None
- cancellationToken
- CancellationToken
等待任务完成期间要观察的 CancellationToken。
返回
表示异步操作的 Task 对象。
- 属性
注解
客户端可以发送给定操作的内容校验和标头，以确保通过网络实现事务完整性。 参数 contentChecksum 允许已有权访问给定字节范围的预计算校验和值的客户端提供该值。 BlobRequestOptions.UseTransactionalMd5如果 或 BlobRequestOptions.UseTransactionalCrc64 属性设置为 true ，并且相应的内容参数设置为 null，则客户端库将在内部计算校验和值。
适用于
WritePagesAsync(Uri, Int64, Int64, Int64, Checksum, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
启动异步操作以将页写入页 Blob。
[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.TaskPublic 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参数
- offset
- Int64
要开始检索内容的源中的字节偏移量。
- count
- Int64
源中要返回的字节数，或 null 从 Blob 末尾返回所有字节的字节数。
- startOffset
- Int64
开始写入的偏移量（以字节为单位）。 偏移量必须是 512 的倍数。
- sourceContentChecksum
- Checksum
- sourceAccessCondition
- AccessCondition
一个 AccessCondition 对象，表示源 Blob 的访问条件。 如果为 null，则不使用任何条件。
- destAccessCondition
- AccessCondition
一个 AccessCondition 对象，表示目标 Blob 的访问条件。 如果为 null，则不使用任何条件。
- options
- BlobRequestOptions
一个 BlobRequestOptions 对象，它指定请求的其他选项。
- operationContext
- OperationContext
一个 OperationContext 对象，它一个表示当前操作的上下文。
- cancellationToken
- CancellationToken
等待任务完成期间要观察的 CancellationToken。
返回
表示异步操作的 Task 对象。
- 属性
