ShareLeaseClient Class
Definition
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
-
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 |
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 |
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
Azure SDK for .NET