ShareLeaseClient Class

Reference

Definition

Namespace:: Azure.Storage.Files.Shares.Specialized

Assembly:: Azure.Storage.Files.Shares.dll

Package:: Azure.Storage.Files.Shares v12.21.0

Package:: Azure.Storage.Files.Shares v12.21.0-beta.2

Source:: ShareLeaseClient.cs

Source:: ShareLeaseClient.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

The ShareLeaseClient allows you to manipulate Azure Storage leases on files.

public class ShareLeaseClient

type ShareLeaseClient = class

Public Class ShareLeaseClient

Inheritance: Object
ShareLeaseClient

Constructors

ShareLeaseClient()	Initializes a new instance of the ShareLeaseClient class for mocking.
ShareLeaseClient(ShareClient, String)	Initializes a new instance of the ShareLeaseClient class.
ShareLeaseClient(ShareFileClient, String)	Initializes a new instance of the ShareLeaseClient class.

Fields

InfiniteLeaseDuration

The TimeSpan representing an infinite lease duration.

Properties

FileClient	The ShareFileClient to manage leases for.
LeaseId	Gets the Lease ID for this lease.
ShareClient	The ShareClient to manage leases for.
Uri	Gets the URI of the object being leased.

Methods

Acquire(Nullable<TimeSpan>, CancellationToken)	The Acquire(Nullable<TimeSpan>, CancellationToken) operation acquires a lease on the file. If the file does not have an active lease, the File service creates a lease on the file and returns it. If the file has an active lease, you can only request a new lease using the active lease ID as LeaseId
AcquireAsync(Nullable<TimeSpan>, CancellationToken)	The AcquireAsync(Nullable<TimeSpan>, CancellationToken) operation acquires a lease on the file. If the file does not have an active lease, the File service creates a lease on the file and returns it. If the file has an active lease, you can only request a new lease using the active lease ID as LeaseId.
Break(CancellationToken)	The Break(CancellationToken) operation breaks the files's previously-acquired lease (if it exists). Once a lease is broken, it cannot be renewed. Any authorized request can break the lease; the request is not required to specify a matching lease ID. A lease that has been broken can also be released. A client can immediately acquire a file lease that has been released.
BreakAsync(CancellationToken)	The BreakAsync(CancellationToken) operation breaks the files's previously-acquired lease (if it exists). Once a lease is broken, it cannot be renewed. Any authorized request can break the lease; the request is not required to specify a matching lease ID. A lease that has been broken can also be released. A client can immediately acquire a file lease that has been released.
Change(String, CancellationToken)	The Change(String, CancellationToken) operation changes the lease of an active lease. A change must include the current LeaseId and a new `proposedId`.
ChangeAsync(String, CancellationToken)	The ChangeAsync(String, CancellationToken) operation changes the lease of an active lease. A change must include the current LeaseId and a new `proposedId`.
Release(CancellationToken)	The Release(CancellationToken) operation releases the files's previously-acquired lease. The lease may be released if the LeaseId matches that associated with the file. Releasing the lease allows another client to immediately acquire the lease for the file as soon as the release is complete.
ReleaseAsync(CancellationToken)	The ReleaseAsync(CancellationToken) operation releases the files's previously-acquired lease. The lease may be released if the LeaseId matches that associated with the file. Releasing the lease allows another client to immediately acquire the lease for the file as soon as the release is complete.
Renew(CancellationToken)	The Renew(CancellationToken) operation renews the shares's previously-acquired lease. This API does not support files. The lease can be renewed if the leaseId matches that associated with the share. Note that the lease may be renewed even if it has expired as long as the share has not been leased again since the expiration of that lease. When you renew a lease, the lease duration clock resets.
RenewAsync(CancellationToken)	The RenewAsync(CancellationToken) operation renews the shares's previously-acquired lease. This API does not support files. The lease can be renewed if the leaseId matches that associated with the share. Note that the lease may be renewed even if it has expired as long as the share has not been leased again since the expiration of that lease. When you renew a lease, the lease duration clock resets.

Applies to

共用方式為