你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
CloudFile.WriteRangeAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，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.TaskPublic 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 对象。
- 属性
适用于
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.TaskPublic 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 对象。
- 属性
适用于
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.TaskPublic 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 对象。
- 属性
适用于
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.TaskPublic Overridable Function WriteRangeAsync (rangeData As Stream, startOffset As Long, contentMD5 As String) As Task参数
- rangeData
- Stream
提供数据的流。
- startOffset
- Int64
开始写入的偏移量（以字节为单位）。
- contentMD5
- String
一个可选哈希值，用于设置 ContentMD5 文件的 属性。 可以是 null 或空字符串。
返回
一个表示当前操作的 Task 对象。
- 属性
适用于
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.TaskPublic 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 对象。
- 属性
适用于
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.TaskPublic 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参数
- sourceOffset
- Int64
开始读取源的偏移量（以字节为单位）。
- count
- Int64
要写入的字节数
- destOffset
- Int64
开始写入的偏移量（以字节为单位）。
- sourceContentChecksum
- Checksum
用于确保事务完整性的哈希值。 可以是 null 或 校验和。None
- sourceAccessCondition
- AccessCondition
一个 AccessCondition 对象，表示源文件的访问条件。 如果为 null，则不使用任何条件。
- options
- FileRequestOptions
一个 FileRequestOptions 对象，它指定请求的其他选项。
- operationContext
- OperationContext
一个表示当前操作上下文的对象。
- cancellationToken
- Nullable<CancellationToken>
等待任务完成期间要观察的 CancellationToken。
返回
- 属性
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈