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

ShareLeaseClient.AcquireAsync 方法

定义

操作 AcquireAsync(Nullable<TimeSpan>, CancellationToken) 获取文件上的租约。

如果文件没有活动的租约,则文件服务会在文件上创建租约并返回它。 如果文件具有活动租约,则只能使用活动租约 ID 作为 LeaseId请求新的租约。

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareFileLease>> AcquireAsync (TimeSpan? duration = default, System.Threading.CancellationToken cancellationToken = default);
abstract member AcquireAsync : Nullable<TimeSpan> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareFileLease>>
override this.AcquireAsync : Nullable<TimeSpan> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareFileLease>>
Public Overridable Function AcquireAsync (Optional duration As Nullable(Of TimeSpan) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of ShareFileLease))

参数

duration
Nullable<TimeSpan>

指定租约的持续时间(以秒为单位),或 InfiniteLeaseDuration 指定永不过期的租约。 有限期租约在 15 到 60 秒之间。 文件仅支持无限租约。 无法使用 RenewAsync(CancellationToken)ChangeAsync(String, CancellationToken) 更改租约持续时间。

cancellationToken
CancellationToken

可选 CancellationToken ,用于传播应取消操作的通知。

返回

描述 Response<T> 租约的 。

注解

RequestFailedException如果失败,将引发 。

适用于