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

CloudAppendBlob.AppendBlockAsync 方法

参考

定义

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

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

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

重要

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

重载

AppendBlockAsync(Stream, String)	启动异步操作，将新的数据块提交到 Blob 的末尾。
AppendBlockAsync(Stream, String, CancellationToken)	启动异步操作，将新的数据块提交到 Blob 的末尾。
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext)	启动异步操作，将新的数据块提交到 Blob 的末尾。
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	启动异步操作，将新的数据块提交到 Blob 的末尾。
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)	启动异步操作，将新的数据块提交到 Blob 的末尾。
AppendBlockAsync(Uri, Int64, Int64, String, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	将新的数据块提交到 Blob 的末尾。

AppendBlockAsync(Stream, String)

启动异步操作，将新的数据块提交到 Blob 的末尾。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync(System.IO.Stream blockData, string contentMD5 = default);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string -> System.Threading.Tasks.Task<int64>

Public Overridable Function AppendBlockAsync (blockData As Stream, Optional contentMD5 As String = Nothing) As Task(Of Long)

参数

blockData: Stream

一个 Stream 对象，它为块提供数据。

contentMD5: String

用于确保事务完整性的可选哈希值。可以是 null 或空字符串。

Task<Int64>

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

注解

客户端可以发送给定 Append Block 操作的 Content-MD5 标头，以确保通过网络实现事务完整性。参数 contentMD5 允许已有权访问给定字节范围的预计算 MD5 值的客户端提供该值。如果属性 BlobRequestOptions.UseTransactionalMd5 设置为 true ，并且 contentMD5 参数设置为 null，则客户端库将在内部计算 MD5 值。

适用于

AppendBlockAsync(Stream, String, CancellationToken)

启动异步操作，将新的数据块提交到 Blob 的末尾。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync(System.IO.Stream blockData, string contentMD5, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>

Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, cancellationToken As CancellationToken) As Task(Of Long)

参数

blockData: Stream

一个 Stream 对象，它为块提供数据。

contentMD5: String

用于确保事务完整性的可选哈希值。可以是 null 或空字符串。

cancellationToken: CancellationToken

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

Task<Int64>

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

注解

客户端可以发送给定 Put Block 操作的 Content-MD5 标头，以确保通过网络实现事务完整性。参数 contentMD5 允许已有权访问给定字节范围的预计算 MD5 值的客户端提供该值。如果属性 BlobRequestOptions.UseTransactionalMd5 设置为 true ，并且 contentMD5 参数设置为 null，则客户端库将在内部计算 MD5 值。

适用于

AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext)

启动异步操作，将新的数据块提交到 Blob 的末尾。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync(System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<int64>

Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task(Of Long)

参数

blockData: Stream

一个 Stream 对象，它为块提供数据。

contentMD5: String

用于确保事务完整性的可选哈希值。可以是 null 或空字符串。

accessCondition: AccessCondition

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

options: BlobRequestOptions

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

operationContext: OperationContext

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

Task<Int64>

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

注解

适用于

AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

启动异步操作，将新的数据块提交到 Blob 的末尾。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync(System.IO.Stream blockData, string contentMD5, 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 AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>

Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Long)

参数

blockData: Stream

一个 Stream 对象，它为块提供数据。

contentMD5: String

用于确保事务完整性的可选哈希值。可以是 null 或空字符串。

accessCondition: AccessCondition

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

options: BlobRequestOptions

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

operationContext: OperationContext

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

cancellationToken: CancellationToken

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

Task<Int64>

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

注解

适用于

AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)

启动异步操作，将新的数据块提交到 Blob 的末尾。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync(System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> progressHandler, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>

Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, progressHandler As IProgress(Of StorageProgress), cancellationToken As CancellationToken) As Task(Of Long)

参数

blockData: Stream

一个 Stream 对象，它为块提供数据。

contentMD5: String

用于确保事务完整性的可选哈希值。可以是 null 或空字符串。

accessCondition: AccessCondition

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

options: BlobRequestOptions

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

operationContext: OperationContext

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

progressHandler: IProgress<StorageProgress>

用于 IProgress<T> 处理 StorageProgress 消息的对象。

cancellationToken: CancellationToken

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

Task<Int64>

表示异步操作的 Task 对象。

属性: DoesServiceRequestAttribute

注解

适用于

AppendBlockAsync(Uri, Int64, Int64, String, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

将新的数据块提交到 Blob 的末尾。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync(Uri sourceUri, long offset, long count, string sourceContentMd5, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition, Microsoft.Azure.Storage.AccessCondition destAccessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : Uri * int64 * int64 * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : Uri * int64 * int64 * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>

Public Overridable Function AppendBlockAsync (sourceUri As Uri, offset As Long, count As Long, sourceContentMd5 As String, sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Long)

参数

sourceUri: Uri

一个 Uri ，指定源 Blob 的绝对 URI。

offset: Int64

源中开始检索内容的字节偏移量。

count: Int64

要从源返回的字节数，或 null 返回到 Blob 末尾的所有字节数。

sourceContentMd5: String

一个可选哈希值，用于在 Blob 上设置 ContentMD5 属性。可以是 null 或空字符串。

sourceAccessCondition: AccessCondition

一个 AccessCondition 对象，表示源 Blob 的访问条件。如果为 null，则不使用任何条件。

destAccessCondition: AccessCondition

一个 AccessCondition 对象，表示目标 Blob 的访问条件。如果为 null，则不使用任何条件。

options: BlobRequestOptions

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

operationContext: OperationContext

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

cancellationToken: CancellationToken

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

Task<Int64>

表示 Task 异步操作的。

属性: DoesServiceRequestAttribute

适用于

通过

CloudAppendBlob.AppendBlockAsync 方法

定义

重载

AppendBlockAsync(Stream, String)

参数

返回

注解

适用于

AppendBlockAsync(Stream, String, CancellationToken)

参数

返回

注解

适用于

AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext)

参数

返回

注解

适用于

AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

参数

返回

注解

适用于

AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)

参数

返回

注解

适用于

AppendBlockAsync(Uri, Int64, Int64, String, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

参数

返回

适用于

其他资源