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

CloudPageBlob.BeginOpenWrite 方法

定义

重载

BeginOpenWrite(Nullable<Int64>, AsyncCallback, Object)

开始异步操作以打开流以写入 Blob。 如果 Blob 已存在,则可能会覆盖该 Blob 中的现有数据。

BeginOpenWrite(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object)

开始异步操作以打开流以写入 Blob。 如果 Blob 已存在,则可能会覆盖该 Blob 中的现有数据。

BeginOpenWrite(Nullable<Int64>, AsyncCallback, Object)

开始异步操作以打开流以写入 Blob。 如果 Blob 已存在,则可能会覆盖该 Blob 中的现有数据。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual Microsoft.Azure.Storage.ICancellableAsyncResult BeginOpenWrite (long? size, AsyncCallback callback, object state);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member BeginOpenWrite : Nullable<int64> * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
override this.BeginOpenWrite : Nullable<int64> * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
Public Overridable Function BeginOpenWrite (size As Nullable(Of Long), callback As AsyncCallback, state As Object) As ICancellableAsyncResult

参数

size
Nullable<Int64>

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

callback
AsyncCallback

AsyncCallback 异步操作完成时接收通知的委托。

state
Object

将传递给回调委托的用户定义对象。

返回

引用 ICancellableAsyncResult 异步操作的 。

属性

注解

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

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

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

适用于

BeginOpenWrite(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object)

开始异步操作以打开流以写入 Blob。 如果 Blob 已存在,则可能会覆盖该 Blob 中的现有数据。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual Microsoft.Azure.Storage.ICancellableAsyncResult BeginOpenWrite (long? size, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, AsyncCallback callback, object state);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member BeginOpenWrite : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
override this.BeginOpenWrite : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
Public Overridable Function BeginOpenWrite (size As Nullable(Of Long), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, callback As AsyncCallback, state As Object) As ICancellableAsyncResult

参数

size
Nullable<Int64>

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

accessCondition
AccessCondition

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

options
BlobRequestOptions

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

operationContext
OperationContext

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

callback
AsyncCallback

AsyncCallback 异步操作完成时接收通知的委托。

state
Object

将传递给回调委托的用户定义对象。

返回

引用 ICancellableAsyncResult 异步操作的 。

属性

注解

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

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

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

适用于