你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
CloudPageBlob.BeginOpenWrite 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
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
参数
- 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
参数
- 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()生成的 对象。