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

CloudFile.WriteRangeAsync 方法

参考

定义

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

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

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

重要

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

重载

WriteRangeAsync(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext, CancellationToken)	返回一个任务，该任务执行异步操作以将范围写入文件。
WriteRangeAsync(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext)	返回一个任务，该任务执行异步操作以将范围写入文件。
WriteRangeAsync(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)	返回一个任务，该任务执行异步操作以将范围写入文件。
WriteRangeAsync(Stream, Int64, String)	返回一个任务，该任务执行异步操作以将范围写入文件。
WriteRangeAsync(Stream, Int64, String, CancellationToken)	返回一个任务，该任务执行异步操作以将范围写入文件。
WriteRangeAsync(Uri, Int64, Int64, Int64, Checksum, AccessCondition, FileRequestOptions, OperationContext, Nullable<CancellationToken>)	将范围从源文件写入此文件。

WriteRangeAsync(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext, CancellationToken)

返回一个任务，该任务执行异步操作以将范围写入文件。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WriteRangeAsync(System.IO.Stream rangeData, long startOffset, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.File.FileRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);

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

Public Overridable Function WriteRangeAsync (rangeData As Stream, startOffset As Long, contentMD5 As String, accessCondition As AccessCondition, options As FileRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task

参数

rangeData: Stream

提供数据的流。

startOffset: Int64

开始写入的偏移量（以字节为单位）。

contentMD5: String

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

accessCondition: AccessCondition

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

options: FileRequestOptions

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

operationContext: OperationContext

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

cancellationToken: CancellationToken

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

Task

一个表示当前操作的 Task 对象。

属性: DoesServiceRequestAttribute

适用于

WriteRangeAsync(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext)

返回一个任务，该任务执行异步操作以将范围写入文件。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WriteRangeAsync(System.IO.Stream rangeData, long startOffset, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.File.FileRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);

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

Public Overridable Function WriteRangeAsync (rangeData As Stream, startOffset As Long, contentMD5 As String, accessCondition As AccessCondition, options As FileRequestOptions, operationContext As OperationContext) As Task

参数

rangeData: Stream

提供数据的流。

startOffset: Int64

开始写入的偏移量（以字节为单位）。

contentMD5: String

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

accessCondition: AccessCondition

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

options: FileRequestOptions

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

operationContext: OperationContext

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

Task

一个表示当前操作的 Task 对象。

属性: DoesServiceRequestAttribute

适用于

WriteRangeAsync(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)

返回一个任务，该任务执行异步操作以将范围写入文件。

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

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

Public Overridable Function WriteRangeAsync (rangeData As Stream, startOffset As Long, contentMD5 As String, accessCondition As AccessCondition, options As FileRequestOptions, operationContext As OperationContext, progressHandler As IProgress(Of StorageProgress), cancellationToken As CancellationToken) As Task

参数

rangeData: Stream

提供数据的流。

startOffset: Int64

开始写入的偏移量（以字节为单位）。

contentMD5: String

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

accessCondition: AccessCondition

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

options: FileRequestOptions

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

operationContext: OperationContext

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

progressHandler: IProgress<StorageProgress>

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

cancellationToken: CancellationToken

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

Task

一个表示当前操作的 Task 对象。

属性: DoesServiceRequestAttribute

适用于

WriteRangeAsync(Stream, Int64, String)

返回一个任务，该任务执行异步操作以将范围写入文件。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WriteRangeAsync(System.IO.Stream rangeData, long startOffset, string contentMD5);

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

Public Overridable Function WriteRangeAsync (rangeData As Stream, startOffset As Long, contentMD5 As String) As Task

参数

rangeData: Stream

提供数据的流。

startOffset: Int64

开始写入的偏移量（以字节为单位）。

contentMD5: String

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

Task

一个表示当前操作的 Task 对象。

属性: DoesServiceRequestAttribute

适用于

WriteRangeAsync(Stream, Int64, String, CancellationToken)

返回一个任务，该任务执行异步操作以将范围写入文件。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WriteRangeAsync(System.IO.Stream rangeData, long startOffset, string contentMD5, System.Threading.CancellationToken cancellationToken);

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

Public Overridable Function WriteRangeAsync (rangeData As Stream, startOffset As Long, contentMD5 As String, cancellationToken As CancellationToken) As Task

参数

rangeData: Stream

提供数据的流。

startOffset: Int64

开始写入的偏移量（以字节为单位）。

contentMD5: String

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

cancellationToken: CancellationToken

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

Task

一个表示当前操作的 Task 对象。

属性: DoesServiceRequestAttribute

适用于

WriteRangeAsync(Uri, Int64, Int64, Int64, Checksum, AccessCondition, FileRequestOptions, OperationContext, Nullable<CancellationToken>)

将范围从源文件写入此文件。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WriteRangeAsync(Uri sourceUri, long sourceOffset, long count, long destOffset, Microsoft.Azure.Storage.Shared.Protocol.Checksum sourceContentChecksum = default, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition = default, Microsoft.Azure.Storage.File.FileRequestOptions options = default, Microsoft.Azure.Storage.OperationContext operationContext = default, System.Threading.CancellationToken? cancellationToken = default);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member WriteRangeAsync : Uri * int64 * int64 * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.File.FileRequestOptions * Microsoft.Azure.Storage.OperationContext * Nullable<System.Threading.CancellationToken> -> System.Threading.Tasks.Task
override this.WriteRangeAsync : Uri * int64 * int64 * int64 * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.File.FileRequestOptions * Microsoft.Azure.Storage.OperationContext * Nullable<System.Threading.CancellationToken> -> System.Threading.Tasks.Task

Public Overridable Function WriteRangeAsync (sourceUri As Uri, sourceOffset As Long, count As Long, destOffset As Long, Optional sourceContentChecksum As Checksum = Nothing, Optional sourceAccessCondition As AccessCondition = Nothing, Optional options As FileRequestOptions = Nothing, Optional operationContext As OperationContext = Nothing, Optional cancellationToken As Nullable(Of CancellationToken) = Nothing) As Task

参数

sourceUri: Uri

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

sourceOffset: Int64

开始读取源的偏移量（以字节为单位）。

count: Int64

要写入的字节数

destOffset: Int64

开始写入的偏移量（以字节为单位）。

sourceContentChecksum: Checksum

用于确保事务完整性的哈希值。可以是 null 或校验和。None

sourceAccessCondition: AccessCondition

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

options: FileRequestOptions

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

operationContext: OperationContext

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

cancellationToken: Nullable<CancellationToken>

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

Task

属性: DoesServiceRequestAttribute

适用于

通过

CloudFile.WriteRangeAsync 方法

定义

重载

WriteRangeAsync(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext, CancellationToken)

参数

返回

适用于

WriteRangeAsync(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext)

参数

返回

适用于

WriteRangeAsync(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)

参数

返回

适用于

WriteRangeAsync(Stream, Int64, String)

参数

返回

适用于

WriteRangeAsync(Stream, Int64, String, CancellationToken)

参数

返回

适用于

WriteRangeAsync(Uri, Int64, Int64, Int64, Checksum, AccessCondition, FileRequestOptions, OperationContext, Nullable<CancellationToken>)

参数

返回

适用于

其他资源