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

CloudPageBlob.WritePagesAsync 方法

定义

重载

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 对象。

属性

注解

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

属性

注解

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

属性

注解

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

属性

注解

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

属性

注解

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

属性

适用于