ShareClient Klasse

Definition

Mit ShareClient können Sie Azure Storage-Freigaben und deren Verzeichnisse und Dateien bearbeiten.

public class ShareClient
type ShareClient = class
Public Class ShareClient
Vererbung
ShareClient

Konstruktoren

ShareClient()

Initialisiert eine neue instance der -Klasse für die ShareClient Simulation.

ShareClient(String, String)

Initialisiert eine neue Instanz der ShareClient-Klasse.

ShareClient(String, String, ShareClientOptions)

Initialisiert eine neue Instanz der ShareClient-Klasse.

ShareClient(Uri, AzureSasCredential, ShareClientOptions)

Initialisiert eine neue Instanz der ShareClient-Klasse.

Beachten Sie, dass die Authentifizierung von Tokenanmeldeinformationen nur mit den Vorgängen GetPermission(String, CancellationToken)auf Freigabeebene, GetPermissionAsync(String, CancellationToken), CreatePermission(String, CancellationToken)und CreatePermissionAsync(String, CancellationToken) kompatibel ist.

ShareClient(Uri, ShareClientOptions)

Initialisiert eine neue Instanz der ShareClient-Klasse.

ShareClient(Uri, StorageSharedKeyCredential, ShareClientOptions)

Initialisiert eine neue Instanz der ShareClient-Klasse.

ShareClient(Uri, TokenCredential, ShareClientOptions)

Initialisiert eine neue Instanz der ShareClient-Klasse.

Beachten Sie, dass die einzigen Vorgänge auf Freigabeebene, die die Authentifizierung von Tokenanmeldeinformationen unterstützen, , CreatePermissionAsync(String, CancellationToken)GetPermission(String, CancellationToken), und GetPermissionAsync(String, CancellationToken)sindCreatePermission(String, CancellationToken).

Dieser Konstruktor ermöglicht auch die Erstellung einer ShareServiceClient , die verwendet werden kann, um eine ShareClient abzuleiten, die über Tokenanmeldeinformationen Authentifizierung verfügt.

Beachten Sie auch, dass ShareTokenIntent derzeit für die Tokenauthentifizierung erforderlich ist.

Eigenschaften

AccountName

Ruft den Speicherkontonamen ab, der dem Freigabeclient entspricht.

CanGenerateSasUri

Bestimmt, ob der Client eine SAS generieren kann. Wenn der Client mit einem StorageSharedKeyCredentialauthentifiziert wird.

Name

Ruft den Namen der Freigabe ab.

Uri

Ruft den primären Uri Endpunkt der Freigabe ab.

Methoden

Create(ShareCreateOptions, CancellationToken)

Der Create(ShareCreateOptions, CancellationToken)-Vorgang erstellt eine neue Freigabe unter dem angegebenen Konto. Wenn bereits eine Freigabe mit demselben Namen vorhanden ist, schlägt der Vorgang fehl.

Weitere Informationen finden Sie unter Erstellen Sie Freigabe.

CreateAsync(ShareCreateOptions, CancellationToken)

Der CreateAsync(ShareCreateOptions, CancellationToken)-Vorgang erstellt eine neue Freigabe unter dem angegebenen Konto. Wenn bereits eine Freigabe mit demselben Namen vorhanden ist, schlägt der Vorgang fehl.

Weitere Informationen finden Sie unter Erstellen Sie Freigabe.

CreateDirectory(String, IDictionary<String,String>, FileSmbProperties, String, CancellationToken)

Der CreateDirectory(String, IDictionary<String,String>, FileSmbProperties, String, CancellationToken) Vorgang erstellt ein neues Verzeichnis in dieser Freigabe.

Weitere Informationen finden Sie unter Verzeichnis erstellen.

CreateDirectoryAsync(String, IDictionary<String,String>, FileSmbProperties, String, CancellationToken)

Der CreateDirectoryAsync(String, IDictionary<String,String>, FileSmbProperties, String, CancellationToken) Vorgang erstellt ein neues Verzeichnis in dieser Freigabe.

Weitere Informationen finden Sie unter Verzeichnis erstellen.

CreateIfNotExists(ShareCreateOptions, CancellationToken)

Der CreateIfNotExists(ShareCreateOptions, CancellationToken)-Vorgang erstellt eine neue Freigabe unter dem angegebenen Konto. Wenn bereits eine Freigabe mit demselben Namen vorhanden ist, wird sie nicht geändert.

Weitere Informationen finden Sie unter Erstellen Sie Freigabe.

CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, CancellationToken)

Der CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, CancellationToken)-Vorgang erstellt eine neue Freigabe unter dem angegebenen Konto. Wenn bereits eine Freigabe mit demselben Namen vorhanden ist, wird sie nicht geändert.

Weitere Informationen finden Sie unter Erstellen Sie Freigabe.

CreateIfNotExistsAsync(ShareCreateOptions, CancellationToken)

Der CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, CancellationToken)-Vorgang erstellt eine neue Freigabe unter dem angegebenen Konto. Wenn bereits eine Freigabe mit demselben Namen vorhanden ist, wird sie nicht geändert.

Weitere Informationen finden Sie unter Erstellen Sie Freigabe.

CreatePermission(String, CancellationToken)

Erstellt eine Berechtigung (eine Sicherheitsbeschreibung) auf Freigabeebene. Der erstellte Sicherheitsdeskriptor kann für die Dateien/Verzeichnisse in der Freigabe verwendet werden.

CreatePermissionAsync(String, CancellationToken)

Erstellt eine Berechtigung (eine Sicherheitsbeschreibung) auf Freigabeebene. Der erstellte Sicherheitsdeskriptor kann für die Dateien/Verzeichnisse in der Freigabe verwendet werden.

CreateSnapshot(IDictionary<String,String>, CancellationToken)

Erstellt eine schreibgeschützte Momentaufnahme einer Freigabe.

Weitere Informationen finden Sie unter Momentaufnahmefreigabe.

CreateSnapshotAsync(IDictionary<String,String>, CancellationToken)

Erstellt eine schreibgeschützte Momentaufnahme einer Freigabe.

Weitere Informationen finden Sie unter Momentaufnahmefreigabe.

Delete(ShareDeleteOptions, CancellationToken)

Markiert die angegebene Freigabe oder freigabe Momentaufnahme zum Löschen. Die Freigabe oder freigabe Momentaufnahme und alle darin enthaltenen Dateien werden später während der Garbage Collection gelöscht, was einige Minuten dauern kann.

Weitere Informationen finden Sie unter Freigabe löschen.

DeleteAsync(ShareDeleteOptions, CancellationToken)

Markiert die angegebene Freigabe oder freigabe Momentaufnahme zum Löschen. Die Freigabe oder freigabe Momentaufnahme und alle darin enthaltenen Dateien werden später während der Garbage Collection gelöscht, was einige Minuten dauern kann.

Weitere Informationen finden Sie unter Freigabe löschen.

DeleteDirectory(String, CancellationToken)

Der DeleteDirectory(String, CancellationToken)-Vorgang entfernt das angegebene leere Verzeichnis.

Weitere Informationen finden Sie unter Verzeichnis löschen.

DeleteDirectoryAsync(String, CancellationToken)

Der DeleteDirectoryAsync(String, CancellationToken)-Vorgang entfernt das angegebene leere Verzeichnis.

Weitere Informationen finden Sie unter Verzeichnis löschen.

DeleteIfExists(ShareDeleteOptions, CancellationToken)

Markiert die angegebene Freigabe oder freigabe Momentaufnahme zum Löschen, sofern vorhanden.

Weitere Informationen finden Sie unter Freigabe löschen.

DeleteIfExistsAsync(ShareDeleteOptions, CancellationToken)

Markiert die angegebene Freigabe oder freigabe Momentaufnahme zum Löschen, sofern vorhanden.

Weitere Informationen finden Sie unter Freigabe löschen.

Exists(CancellationToken)

Der Exists(CancellationToken) Vorgang kann für einen ShareClient aufgerufen werden, um festzustellen, ob die zugeordnete Freigabe im Speicherkonto im Speicherdienst vorhanden ist.

ExistsAsync(CancellationToken)

Der ExistsAsync(CancellationToken) Vorgang kann für einen ShareClient aufgerufen werden, um festzustellen, ob die zugeordnete Freigabe im Speicherkonto im Speicherdienst vorhanden ist.

GenerateSasUri(ShareSasBuilder)

Gibt GenerateSasUri(ShareSasBuilder) einen Uri zurück, der basierend auf den übergebenen Clienteigenschaften und dem übergebenen Generator einen SAS-URI (Shared Access Signature) für blob Container Service generiert. Die SAS wird von den Anmeldeinformationen für gemeinsam genutzte Schlüssel des Clients signiert.

Informationen zum Überprüfen, ob der Client eine Dienst-Sas signieren kann, finden Sie unter CanGenerateSasUri.

Weitere Informationen finden Sie unter Erstellen einer Dienst-SAS.

GenerateSasUri(ShareSasPermissions, DateTimeOffset)

Gibt GenerateSasUri(ShareSasPermissions, DateTimeOffset) einen Uri zurück, der basierend auf den übergebenen Clienteigenschaften und Parametern einen SAS-URI (Share Service Shared Access Signature) generiert. Die SAS wird von den Anmeldeinformationen für gemeinsam genutzte Schlüssel des Clients signiert.

Informationen zum Überprüfen, ob der Client eine Dienst-Sas signieren kann, finden Sie unter CanGenerateSasUri.

Weitere Informationen finden Sie unter Erstellen einer Dienst-SAS.

GetAccessPolicy(ShareFileRequestConditions, CancellationToken)

Der GetAccessPolicy(ShareFileRequestConditions, CancellationToken) Vorgang ruft die Berechtigungen für diese Freigabe ab. Die Berechtigungen geben an, ob auf Freigabedaten öffentlich zugegriffen werden darf.

Weitere Informationen finden Sie unter Abrufen der Freigabe-ACL.

GetAccessPolicyAsync(ShareFileRequestConditions, CancellationToken)

Der GetAccessPolicyAsync(ShareFileRequestConditions, CancellationToken) Vorgang ruft die Berechtigungen für diese Freigabe ab. Die Berechtigungen geben an, ob auf Freigabedaten öffentlich zugegriffen werden darf.

Weitere Informationen finden Sie unter Abrufen der Freigabe-ACL.

GetDirectoryClient(String)

Erstellen Sie ein neues ShareDirectoryClient -Objekt, indem Sie am Ende von UrianfügendirectoryName. Die neue ShareDirectoryClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareClient.

GetParentServiceClientCore()

Erstellen Sie eine neue ShareServiceClient , die auf den übergeordneten Container verweist ShareClient. Die neue ShareServiceClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareClient.

GetPermission(String, CancellationToken)

Ruft die Dateiberechtigung in Security Descriptor Definition Language (SDDL) ab.

GetPermissionAsync(String, CancellationToken)

Ruft die Dateiberechtigung in Security Descriptor Definition Language (SDDL) ab.

GetProperties(ShareFileRequestConditions, CancellationToken)

Der GetProperties(ShareFileRequestConditions, CancellationToken) Vorgang gibt alle benutzerdefinierten Metadaten, HTTP-Standardeigenschaften und Systemeigenschaften für die Freigabe zurück.

Weitere Informationen finden Sie unter Abrufen von Freigabeeigenschaften.

GetPropertiesAsync(ShareFileRequestConditions, CancellationToken)

Der GetPropertiesAsync(ShareFileRequestConditions, CancellationToken) Vorgang gibt alle benutzerdefinierten Metadaten, HTTP-Standardeigenschaften und Systemeigenschaften für die Freigabe zurück.

Weitere Informationen finden Sie unter Abrufen von Freigabeeigenschaften.

GetRootDirectoryClient()

Erstellen Sie ein ShareDirectoryClient -Objekt für den Stamm der Freigabe. Die neue ShareDirectoryClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareClient.

GetStatistics(ShareFileRequestConditions, CancellationToken)

Ruft Statistiken im Zusammenhang mit der Freigabe ab.

Weitere Informationen finden Sie unter Abrufen von Freigabestatistiken.

GetStatisticsAsync(ShareFileRequestConditions, CancellationToken)

Ruft Statistiken im Zusammenhang mit der Freigabe ab.

Weitere Informationen finden Sie unter Abrufen von Freigabestatistiken.

SetAccessPolicy(IEnumerable<ShareSignedIdentifier>, ShareFileRequestConditions, CancellationToken)

Der SetAccessPolicy(IEnumerable<ShareSignedIdentifier>, ShareFileRequestConditions, CancellationToken) Vorgang legt die Berechtigungen für die angegebene Freigabe fest. Die Berechtigungen geben an, ob auf Freigabedaten öffentlich zugegriffen werden darf.

Weitere Informationen finden Sie unter Legen Sie Freigabe-ACL fest.

SetAccessPolicyAsync(IEnumerable<ShareSignedIdentifier>, ShareFileRequestConditions, CancellationToken)

Der SetAccessPolicyAsync(IEnumerable<ShareSignedIdentifier>, ShareFileRequestConditions, CancellationToken) Vorgang legt die Berechtigungen für die angegebene Freigabe fest. Die Berechtigungen geben an, ob auf Freigabedaten öffentlich zugegriffen werden darf.

Weitere Informationen finden Sie unter Legen Sie Freigabe-ACL fest.

SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken)

Der SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) Vorgang legt benutzerdefinierte Metadaten für die angegebene Freigabe als mindestens ein Name-Wert-Paar fest.

Weitere Informationen finden Sie unter Legen Sie Freigabemetadaten fest.

SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken)

Der SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) Vorgang legt benutzerdefinierte Metadaten für die angegebene Freigabe als mindestens ein Name-Wert-Paar fest.

Weitere Informationen finden Sie unter Legen Sie Freigabemetadaten fest.

SetProperties(ShareSetPropertiesOptions, CancellationToken)

Legt die Eigenschaften der Freigabe fest.

Weitere Informationen finden Sie unter Legen Sie Freigabeeigenschaften fest.

SetPropertiesAsync(ShareSetPropertiesOptions, CancellationToken)

Legt die Eigenschaften der Freigabe fest.

Weitere Informationen finden Sie unter Legen Sie Freigabeeigenschaften fest.

WithSnapshot(String)

Initialisiert einen neuen instance der ShareClient -Klasse mit einer identischen Uri Quelle, aber dem angegebenen snapshot Zeitstempel.

Weitere Informationen finden Sie unter Momentaufnahmefreigabe.

Erweiterungsmethoden

GetShareLeaseClient(ShareClient, String)

Initialisiert eine neue Instanz der ShareLeaseClient-Klasse.

GetParentServiceClient(ShareClient)

Erstellen Sie eine neue ShareServiceClient , die auf den übergeordneten Container verweist ShareClient. Die neue ShareServiceClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareClient.

Gilt für: