你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

CloudPageBlob.WritePagesAsync 方法

参考

定义

命名空间:: Microsoft.Azure.Storage.Blob

程序集:: Microsoft.Azure.Storage.Blob.dll

包:: Microsoft.Azure.Storage.Blob v11.2.3

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	启动异步操作以将页写入页 Blob。
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext)	启动异步操作以将页写入页 Blob。
WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)	启动异步操作以将页写入页 Blob。
WritePagesAsync(Stream, Int64, Checksum)	启动异步操作以将页写入页 Blob。
WritePagesAsync(Stream, Int64, Checksum, CancellationToken)	启动异步操作以将页写入页 Blob。
WritePagesAsync(Uri, Int64, Int64, Int64, Checksum, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	启动异步操作以将页写入页 Blob。

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.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

参数

pageData: Stream

提供 Stream 页面数据的对象。

startOffset: Int64

开始写入的偏移量（以字节为单位）。偏移量必须是 512 的倍数。

contentChecksum: Checksum

用于确保事务完整性的哈希值。可以是 null 或校验和。None

accessCondition: AccessCondition

一个 AccessCondition 对象，表示继续处理请求而必须满足的条件。如果为 null，则不使用任何条件。

options: BlobRequestOptions

一个 BlobRequestOptions 对象，它指定请求的其他选项。

operationContext: OperationContext

一个 OperationContext 对象，它一个表示当前操作的上下文。

cancellationToken: CancellationToken

等待任务完成期间要观察的 CancellationToken。

Task

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

注解

客户端可以发送给定操作的内容校验和标头，以确保通过网络实现事务完整性。参数 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.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

参数

pageData: Stream

提供 Stream 页面数据的对象。

startOffset: Int64

开始写入的偏移量（以字节为单位）。偏移量必须是 512 的倍数。

contentChecksum: Checksum

用于确保事务完整性的哈希值。可以是 null 或校验和。None

accessCondition: AccessCondition

一个 AccessCondition 对象，表示继续处理请求而必须满足的条件。如果为 null，则不使用任何条件。

options: BlobRequestOptions

一个 BlobRequestOptions 对象，它指定请求的其他选项。

operationContext: OperationContext

一个 OperationContext 对象，它一个表示当前操作的上下文。

Task

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

注解

适用于

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.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

参数

pageData: Stream

提供 Stream 页面数据的对象。

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

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

注解

适用于

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.Task

Public Overridable Function WritePagesAsync (pageData As Stream, startOffset As Long, contentChecksum As Checksum) As Task

参数

pageData: Stream

提供 Stream 页面数据的对象。

startOffset: Int64

开始写入的偏移量（以字节为单位）。偏移量必须是 512 的倍数。

contentChecksum: Checksum

用于确保事务完整性的可选哈希值。可以是 null 或校验和。None

Task

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

注解

适用于

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.Task

Public Overridable Function WritePagesAsync (pageData As Stream, startOffset As Long, contentChecksum As Checksum, cancellationToken As CancellationToken) As Task

参数

pageData: Stream

提供 Stream 页面数据的对象。

startOffset: Int64

开始写入的偏移量（以字节为单位）。偏移量必须是 512 的倍数。

contentChecksum: Checksum

用于确保事务完整性的哈希值。可以是 null 或校验和。None

cancellationToken: CancellationToken

等待任务完成期间要观察的 CancellationToken。

Task

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

注解

适用于

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.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

参数

sourceUri: Uri

一个 Uri ，指定源 blob 的绝对 URI。

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

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

适用于

Share via

CloudPageBlob.WritePagesAsync 方法

定义

重载

WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

参数

返回

注解

适用于

WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext)

参数

返回

注解

适用于

WritePagesAsync(Stream, Int64, Checksum, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)

参数

返回

注解

适用于

WritePagesAsync(Stream, Int64, Checksum)

参数

返回

注解

适用于

WritePagesAsync(Stream, Int64, Checksum, CancellationToken)

参数

返回

注解

适用于

WritePagesAsync(Uri, Int64, Int64, Int64, Checksum, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

参数

返回

适用于

反馈

其他资源