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

CloudPageBlob.OpenWriteAsync 方法

定义

重载

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 对象,它一个表示当前操作的上下文。

返回

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

属性

注解

请注意,此方法始终在封面下调用 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

返回

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

属性

注解

请注意,此方法始终在封面下调用 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

返回

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

属性

注解

请注意,此方法始终在封面下调用 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 必须已存在。

返回

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

属性

注解

请注意,此方法始终在封面下调用 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

返回

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

属性

注解

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

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

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

适用于