你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
CloudBlockBlob.OpenWriteAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| OpenWriteAsync(AccessCondition, BlobRequestOptions, OperationContext) |
启动异步操作以便打开向 Blob 写入内容的流。 如果 Blob 已存在，则会将其覆盖。 |
| OpenWriteAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) |
启动异步操作以便打开向 Blob 写入内容的流。 如果 Blob 已存在，则会将其覆盖。 |
| OpenWriteAsync() |
启动异步操作以便打开向 Blob 写入内容的流。 如果 Blob 已存在，则会将其覆盖。 |
| OpenWriteAsync(CancellationToken) |
启动异步操作以便打开向 Blob 写入内容的流。 如果 Blob 已存在，则会将其覆盖。 |
OpenWriteAsync(AccessCondition, BlobRequestOptions, OperationContext)
启动异步操作以便打开向 Blob 写入内容的流。 如果 Blob 已存在，则会将其覆盖。
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWriteAsync : 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 : 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 (accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task(Of CloudBlobStream)参数
- accessCondition
- AccessCondition
一个 AccessCondition 对象，表示继续处理请求而必须满足的条件。 如果为 null，则不使用任何条件。
- options
- BlobRequestOptions
一个 BlobRequestOptions 对象，它指定请求的其他选项。
- operationContext
- OperationContext
一个 OperationContext 对象，它一个表示当前操作的上下文。
返回
表示异步操作的 CloudBlobStream 类型的 Task<TResult> 对象。
- 属性
注解
请注意，此方法始终在封面下调用 FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) 方法。
StreamWriteSizeInBytes在调用此方法之前设置 属性，以指定要写入的块大小（以字节为单位），范围介于 16 KB 和 100 MB 之间（包括 16 KB 到 100 MB 之间）。
若要在 Blob 存在时引发异常，而不是覆盖它，请传入 AccessCondition 使用 GenerateIfNotExistsCondition()生成的 对象。
适用于
OpenWriteAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
启动异步操作以便打开向 Blob 写入内容的流。 如果 Blob 已存在，则会将其覆盖。
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (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 : 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 : 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 (accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of CloudBlobStream)参数
- accessCondition
- AccessCondition
一个 AccessCondition 对象，表示继续处理请求而必须满足的条件。 如果为 null，则不使用任何条件。
- options
- BlobRequestOptions
一个 BlobRequestOptions 对象，它指定请求的其他选项。
- operationContext
- OperationContext
一个 OperationContext 对象，它一个表示当前操作的上下文。
- cancellationToken
- CancellationToken
等待任务完成期间要观察的 CancellationToken。
返回
表示异步操作的 CloudBlobStream 类型的 Task<TResult> 对象。
- 属性
注解
请注意，此方法始终在封面下调用 FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) 方法。
StreamWriteSizeInBytes在调用此方法之前设置 属性，以指定要写入的块大小（以字节为单位），范围介于 16 KB 和 100 MB 之间（包括 16 KB 到 100 MB 之间）。
若要在 Blob 存在时引发异常，而不是覆盖它，请传入 AccessCondition 使用 GenerateIfNotExistsCondition()生成的 对象。
适用于
OpenWriteAsync()
启动异步操作以便打开向 Blob 写入内容的流。 如果 Blob 已存在，则会将其覆盖。
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync ();[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWriteAsync : unit -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : unit -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>Public Overridable Function OpenWriteAsync () As Task(Of CloudBlobStream)返回
表示异步操作的 CloudBlobStream 类型的 Task<TResult> 对象。
- 属性
注解
请注意，此方法始终在封面下调用 FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) 方法。
StreamWriteSizeInBytes在调用此方法之前设置 属性，以指定要写入的块大小（以字节为单位），范围介于 16 KB 和 100 MB 之间（包括 16 KB 到 100 MB 之间）。
若要在 Blob 存在时引发异常，而不是覆盖它，请参阅 OpenWriteAsync(AccessCondition, BlobRequestOptions, OperationContext)。
适用于
OpenWriteAsync(CancellationToken)
启动异步操作以便打开向 Blob 写入内容的流。 如果 Blob 已存在，则会将其覆盖。
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (System.Threading.CancellationToken cancellationToken);[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWriteAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>Public Overridable Function OpenWriteAsync (cancellationToken As CancellationToken) As Task(Of CloudBlobStream)参数
- cancellationToken
- CancellationToken
等待任务完成期间要观察的 CancellationToken。
返回
表示异步操作的 CloudBlobStream 类型的 Task<TResult> 对象。
- 属性
注解
请注意，此方法始终在封面下调用 FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) 方法。
StreamWriteSizeInBytes在调用此方法之前设置 属性，以指定要写入的块大小（以字节为单位），范围介于 16 KB 和 100 MB 之间（包括 16 KB 到 100 MB 之间）。
若要在 Blob 存在时引发异常，而不是覆盖它，请参阅 OpenWriteAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)。
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈