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

CloudPageBlob.OpenWriteAsync 方法

参考

定义

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

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

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

重要

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

重载

OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext)	启动异步操作以便打开向 Blob 写入内容的流。如果 Blob 已存在，则可能会覆盖 Blob 中的现有数据。
OpenWriteAsync(Nullable<Int64>, Nullable<PremiumPageBlobTier>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	启动异步操作以便打开向 Blob 写入内容的流。如果 Blob 已存在，则可能会覆盖 Blob 中的现有数据。
OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	启动异步操作以便打开向 Blob 写入内容的流。如果 Blob 已存在，则可能会覆盖 Blob 中的现有数据。
OpenWriteAsync(Nullable<Int64>)	启动异步操作以便打开向 Blob 写入内容的流。如果 Blob 已存在，则可能会覆盖 Blob 中的现有数据。
OpenWriteAsync(Nullable<Int64>, CancellationToken)	启动异步操作以便打开向 Blob 写入内容的流。如果 Blob 已存在，则可能会覆盖 Blob 中的现有数据。

OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext)

启动异步操作以便打开向 Blob 写入内容的流。如果 Blob 已存在，则可能会覆盖 Blob 中的现有数据。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (long? size, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWriteAsync : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>

Public Overridable Function OpenWriteAsync (size As Nullable(Of Long), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task(Of CloudBlobStream)

参数

size: Nullable<Int64>

页 Blob 的大小（以字节为单位）。此大小必须是 512 的倍数。如果 null为，则页 Blob 必须已存在。

accessCondition: AccessCondition

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

options: BlobRequestOptions

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

operationContext: OperationContext

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

Task<CloudBlobStream>

表示异步操作的 CloudBlobStream 类型的 Task<TResult> 对象。

属性: DoesServiceRequestAttribute

注解

请注意，此方法始终在封面下调用 FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) 方法。

StreamWriteSizeInBytes在调用此方法之前设置属性，以 512 字节的倍数指定要写入的页面大小，范围为 512 到 4 MB（含）。

若要在 Blob 存在时引发异常，而不是覆盖它，请传入 AccessCondition 使用 GenerateIfNotExistsCondition()生成的对象。

适用于

OpenWriteAsync(Nullable<Int64>, Nullable<PremiumPageBlobTier>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

启动异步操作以便打开向 Blob 写入内容的流。如果 Blob 已存在，则可能会覆盖 Blob 中的现有数据。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (long? size, Microsoft.Azure.Storage.Blob.PremiumPageBlobTier? premiumPageBlobTier, 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 OpenWriteAsync : Nullable<int64> * Nullable<Microsoft.Azure.Storage.Blob.PremiumPageBlobTier> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : Nullable<int64> * Nullable<Microsoft.Azure.Storage.Blob.PremiumPageBlobTier> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>

Public Overridable Function OpenWriteAsync (size As Nullable(Of Long), premiumPageBlobTier As Nullable(Of PremiumPageBlobTier), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of CloudBlobStream)

参数

size: Nullable<Int64>

页 Blob 的大小（以字节为单位）。此大小必须是 512 的倍数。如果 null为，则页 Blob 必须已存在。

premiumPageBlobTier: Nullable<PremiumPageBlobTier>

表示 PremiumPageBlobTier 要设置的层的。

accessCondition: AccessCondition

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

options: BlobRequestOptions

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

operationContext: OperationContext

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

cancellationToken: CancellationToken

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

Task<CloudBlobStream>

表示异步操作的 CloudBlobStream 类型的 Task<TResult> 对象。

属性: DoesServiceRequestAttribute

注解

请注意，此方法始终在封面下调用 FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) 方法。

StreamWriteSizeInBytes在调用此方法之前设置属性，以 512 字节的倍数指定要写入的页面大小，范围为 512 到 4 MB（含）。

若要在 Blob 存在时引发异常，而不是覆盖它，请传入 AccessCondition 使用 GenerateIfNotExistsCondition()生成的对象。

适用于

OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

启动异步操作以便打开向 Blob 写入内容的流。如果 Blob 已存在，则可能会覆盖 Blob 中的现有数据。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (long? size, 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 OpenWriteAsync : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>

Public Overridable Function OpenWriteAsync (size As Nullable(Of Long), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of CloudBlobStream)

参数

size: Nullable<Int64>

页 Blob 的大小（以字节为单位）。此大小必须是 512 的倍数。如果 null为，则页 Blob 必须已存在。

accessCondition: AccessCondition

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

options: BlobRequestOptions

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

operationContext: OperationContext

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

cancellationToken: CancellationToken

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

Task<CloudBlobStream>

表示异步操作的 CloudBlobStream 类型的 Task<TResult> 对象。

属性: DoesServiceRequestAttribute

注解

请注意，此方法始终在封面下调用 FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) 方法。

StreamWriteSizeInBytes在调用此方法之前设置属性，以 512 字节的倍数指定要写入的页面大小，范围为 512 到 4 MB（含）。

若要在 Blob 存在时引发异常，而不是覆盖它，请传入 AccessCondition 使用 GenerateIfNotExistsCondition()生成的对象。

适用于

OpenWriteAsync(Nullable<Int64>)

启动异步操作以便打开向 Blob 写入内容的流。如果 Blob 已存在，则可能会覆盖 Blob 中的现有数据。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (long? size);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWriteAsync : Nullable<int64> -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : Nullable<int64> -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>

Public Overridable Function OpenWriteAsync (size As Nullable(Of Long)) As Task(Of CloudBlobStream)

参数

size: Nullable<Int64>

页 Blob 的大小（以字节为单位）。此大小必须是 512 的倍数。如果 null为，则页 Blob 必须已存在。

Task<CloudBlobStream>

表示异步操作的 CloudBlobStream 类型的 Task<TResult> 对象。

属性: DoesServiceRequestAttribute

注解

请注意，此方法始终在封面下调用 FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) 方法。

StreamWriteSizeInBytes在调用此方法之前设置属性，以 512 字节的倍数指定要写入的页面大小，范围为 512 到 4 MB（含）。

若要在 Blob 存在时引发异常，而不是覆盖它，请参阅 OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext)。

适用于

OpenWriteAsync(Nullable<Int64>, CancellationToken)

启动异步操作以便打开向 Blob 写入内容的流。如果 Blob 已存在，则可能会覆盖 Blob 中的现有数据。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (long? size, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWriteAsync : Nullable<int64> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : Nullable<int64> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>

Public Overridable Function OpenWriteAsync (size As Nullable(Of Long), cancellationToken As CancellationToken) As Task(Of CloudBlobStream)

参数

size: Nullable<Int64>

页 Blob 的大小（以字节为单位）。此大小必须是 512 的倍数。如果 null为，则页 Blob 必须已存在。

cancellationToken: CancellationToken

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

Task<CloudBlobStream>

表示异步操作的 CloudBlobStream 类型的 Task<TResult> 对象。

属性: DoesServiceRequestAttribute

注解

请注意，此方法始终在封面下调用 FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) 方法。

StreamWriteSizeInBytes在调用此方法之前设置属性，以 512 字节的倍数指定要写入的页面大小，范围为 512 到 4 MB（含）。

若要在 Blob 存在时引发异常，而不是覆盖它，请参阅 OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)。

适用于

通过

CloudPageBlob.OpenWriteAsync 方法

定义

重载

OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext)

参数

返回

注解

适用于

OpenWriteAsync(Nullable<Int64>, Nullable<PremiumPageBlobTier>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

参数

返回

注解

适用于

OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

参数

返回

注解

适用于

OpenWriteAsync(Nullable<Int64>)

参数

返回

注解

适用于

OpenWriteAsync(Nullable<Int64>, CancellationToken)

参数

返回

注解

适用于

其他资源