你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
CloudAppendBlob.AppendBlock 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
AppendBlock(Uri, Int64, Int64, Checksum, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext)
将新的数据块提交到 Blob 的末尾。
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual long AppendBlock (Uri sourceUri, long offset, long count, Microsoft.Azure.Storage.Shared.Protocol.Checksum sourceContentChecksum, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition = default, Microsoft.Azure.Storage.AccessCondition destAccessCondition = default, Microsoft.Azure.Storage.Blob.BlobRequestOptions options = default, Microsoft.Azure.Storage.OperationContext operationContext = default);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlock : Uri * int64 * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> int64
override this.AppendBlock : Uri * int64 * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> int64
Public Overridable Function AppendBlock (sourceUri As Uri, offset As Long, count As Long, sourceContentChecksum As Checksum, Optional sourceAccessCondition As AccessCondition = Nothing, Optional destAccessCondition As AccessCondition = Nothing, Optional options As BlobRequestOptions = Nothing, Optional operationContext As OperationContext = Nothing) As Long
参数
- offset
- Int64
源中开始检索内容的字节偏移量。
- count
- Int64
要从源返回的字节数,或 null
返回到 Blob 末尾的所有字节数。
- sourceContentChecksum
- Checksum
用于确保事务完整性的哈希值。 可以是 null
或 校验和。None
- sourceAccessCondition
- AccessCondition
一个 AccessCondition 对象,表示源 Blob 的访问条件。 如果为 null
,则不使用任何条件。
- destAccessCondition
- AccessCondition
一个 AccessCondition 对象,表示目标 Blob 的访问条件。 如果为 null
,则不使用任何条件。
- options
- BlobRequestOptions
一个 BlobRequestOptions 对象,它指定请求的其他选项。 如果 null
为 ,则默认选项应用于请求。
- operationContext
- OperationContext
一个 OperationContext 对象,它一个表示当前操作的上下文。
返回
块的追加偏移量。
- 属性
适用于
AppendBlock(Stream, Checksum, AccessCondition, BlobRequestOptions, OperationContext)
将新的数据块提交到 Blob 的末尾。
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual long AppendBlock (System.IO.Stream blockData, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum = default, Microsoft.Azure.Storage.AccessCondition accessCondition = default, Microsoft.Azure.Storage.Blob.BlobRequestOptions options = default, Microsoft.Azure.Storage.OperationContext operationContext = default);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlock : System.IO.Stream * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> int64
override this.AppendBlock : System.IO.Stream * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> int64
Public Overridable Function AppendBlock (blockData As Stream, Optional contentChecksum As Checksum = Nothing, Optional accessCondition As AccessCondition = Nothing, Optional options As BlobRequestOptions = Nothing, Optional operationContext As OperationContext = Nothing) As Long
参数
- contentChecksum
- Checksum
用于确保事务完整性的可选哈希值。 可以是 null
或 校验和。None
- accessCondition
- AccessCondition
一个 AccessCondition 对象,表示继续处理请求而必须满足的条件。 如果为 null
,则不使用任何条件。
- options
- BlobRequestOptions
一个 BlobRequestOptions 对象,它指定请求的其他选项。 如果 null
为 ,则默认选项应用于请求。
- operationContext
- OperationContext
一个 OperationContext 对象,它一个表示当前操作的上下文。
返回
块的追加偏移量。
- 属性
注解
客户端可以发送给定操作的内容校验和标头,以确保通过网络实现事务完整性。 参数 contentChecksum
允许已有权访问给定字节范围的预计算校验和值的客户端提供该值。 BlobRequestOptions.UseTransactionalMd5如果 或 BlobRequestOptions.UseTransactionalCrc64 属性设置为 true
,并且相应的内容参数设置为 null
,则客户端库将在内部计算校验和值。