ShareDirectoryClient Klasse

Definition

Ein DirectoryClient stellt einen URI für den Azure Storage-Dateidienst dar, mit dem Sie ein Verzeichnis bearbeiten können.

public class ShareDirectoryClient
type ShareDirectoryClient = class
Public Class ShareDirectoryClient
Vererbung
ShareDirectoryClient

Konstruktoren

ShareDirectoryClient()

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

ShareDirectoryClient(String, String, String)

Initialisiert eine neue Instanz der ShareDirectoryClient-Klasse.

ShareDirectoryClient(String, String, String, ShareClientOptions)

Initialisiert eine neue Instanz der ShareDirectoryClient-Klasse.

ShareDirectoryClient(Uri, AzureSasCredential, ShareClientOptions)

Initialisiert eine neue Instanz der ShareDirectoryClient-Klasse.

ShareDirectoryClient(Uri, ShareClientOptions)

Initialisiert eine neue Instanz der ShareDirectoryClient-Klasse.

ShareDirectoryClient(Uri, StorageSharedKeyCredential, ShareClientOptions)

Initialisiert eine neue Instanz der ShareDirectoryClient-Klasse.

ShareDirectoryClient(Uri, TokenCredential, ShareClientOptions)

Initialisiert eine neue Instanz der ShareDirectoryClient-Klasse.

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

Eigenschaften

AccountName

Ruft den Speicherkontonamen ab, der dem Verzeichnisclient entspricht.

CanGenerateSasUri

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

Name

Ruft den Namen des Verzeichnisses ab.

Path

Ruft den Pfad des Verzeichnisses ab.

ShareName

Ruft den Freigabenamen ab, der dem Verzeichnisclient entspricht.

Uri

Ruft den primären Uri Endpunkt des Verzeichnisses ab.

Methoden

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

Der Create(IDictionary<String,String>, FileSmbProperties, String, CancellationToken) Vorgang erstellt ein neues Verzeichnis am angegebenen Uri.

Weitere Informationen finden Sie unter Verzeichnis erstellen.

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

Der CreateAsync(IDictionary<String,String>, FileSmbProperties, String, CancellationToken) Vorgang erstellt ein neues Verzeichnis am angegebenen Uri.

Weitere Informationen finden Sie unter Verzeichnis erstellen.

CreateFile(String, Int64, ShareFileHttpHeaders, IDictionary<String,String>, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)

Erstellt eine neue Datei oder ersetzt eine vorhandene Datei.

Weitere Informationen finden Sie unter Datei erstellen.

CreateFileAsync(String, Int64, ShareFileHttpHeaders, IDictionary<String, String>, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)

Erstellt eine neue Datei oder ersetzt eine vorhandene Datei.

Weitere Informationen finden Sie unter Datei erstellen.

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

Der CreateIfNotExists(IDictionary<String,String>, FileSmbProperties, String, CancellationToken) Vorgang erstellt ein neues Verzeichnis, sofern es noch nicht vorhanden ist. Wenn das Verzeichnis bereits vorhanden ist, wird es nicht geändert.

Weitere Informationen finden Sie unter Verzeichnis erstellen.

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

Der CreateIfNotExistsAsync(IDictionary<String,String>, FileSmbProperties, String, CancellationToken) Vorgang erstellt ein neues Verzeichnis, sofern es noch nicht vorhanden ist. Wenn das Verzeichnis bereits vorhanden ist, wird es nicht geändert.

Weitere Informationen finden Sie unter Verzeichnis erstellen.

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

Der CreateSubdirectory(String, IDictionary<String,String>, FileSmbProperties, String, CancellationToken) Vorgang erstellt ein neues Unterverzeichnis unter diesem Verzeichnis.

Weitere Informationen finden Sie unter Verzeichnis erstellen.

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

Der CreateSubdirectoryAsync(String, IDictionary<String,String>, FileSmbProperties, String, CancellationToken) Vorgang erstellt ein neues Unterverzeichnis unter diesem Verzeichnis.

Weitere Informationen finden Sie unter Verzeichnis erstellen.

Delete(CancellationToken)

Der Delete(CancellationToken)-Vorgang entfernt das angegebene leere Verzeichnis.

Weitere Informationen finden Sie unter Verzeichnis löschen.

DeleteAsync(CancellationToken)

Der DeleteAsync(CancellationToken)-Vorgang entfernt das angegebene leere Verzeichnis.

Weitere Informationen finden Sie unter Verzeichnis löschen.

DeleteFile(String, ShareFileRequestConditions, CancellationToken)

Durch den DeleteFile(String, ShareFileRequestConditions, CancellationToken)-Vorgang wird die Datei sofort aus dem Speicherkonto entfernt.

Weitere Informationen finden Sie unter Datei löschen.

DeleteFileAsync(String, ShareFileRequestConditions, CancellationToken)

Durch den DeleteFile(String, ShareFileRequestConditions, CancellationToken)-Vorgang wird die Datei sofort aus dem Speicherkonto entfernt.

Weitere Informationen finden Sie unter Datei löschen.

DeleteIfExists(CancellationToken)

Der DeleteIfExists(CancellationToken) Vorgang entfernt das angegebene leere Verzeichnis, sofern vorhanden.

Weitere Informationen finden Sie unter Verzeichnis löschen.

DeleteIfExistsAsync(CancellationToken)

Der DeleteIfExistsAsync(CancellationToken) Vorgang entfernt das angegebene leere Verzeichnis, sofern vorhanden.

Weitere Informationen finden Sie unter Verzeichnis löschen.

DeleteSubdirectory(String, CancellationToken)

Der DeleteSubdirectory(String, CancellationToken) Vorgang entfernt das angegebene leere Unterverzeichnis.

Weitere Informationen finden Sie unter Verzeichnis löschen.

DeleteSubdirectoryAsync(String, CancellationToken)

Der DeleteSubdirectoryAsync(String, CancellationToken) Vorgang entfernt das angegebene leere Unterverzeichnis.

Weitere Informationen finden Sie unter Verzeichnis löschen.

Exists(CancellationToken)

Der Exists(CancellationToken) Vorgang kann für ein ShareDirectoryClient aufgerufen werden, um festzustellen, ob das zugeordnete Verzeichnis in der Freigabe für das Speicherkonto im Speicherdienst vorhanden ist.

ExistsAsync(CancellationToken)

Der Exists(CancellationToken) Vorgang kann für ein ShareDirectoryClient aufgerufen werden, um festzustellen, ob das zugeordnete Verzeichnis in der Freigabe für das Speicherkonto im Speicherdienst vorhanden ist.

ForceCloseAllHandles(Nullable<Boolean>, CancellationToken)

Der ForceCloseAllHandles(Nullable<Boolean>, CancellationToken) Vorgang schließt alle Handles, die in einem Verzeichnis oder einer Datei im Dienst geöffnet werden. Optional werden rekursiv schließende Handles für Unterressourcen unterstützt, wenn die Ressource ein Verzeichnis ist.

Diese API soll zusammen GetHandles(Nullable<Boolean>, CancellationToken) verwendet werden, um schließende Handles zu erzwingen, die Vorgänge blockieren, z. B. das Umbenennen eines Verzeichnisses. Diese Handles sind möglicherweise durch SMB-Clients kompromittiert oder verloren gegangen. Die API hat clientseitige Auswirkungen auf das zu schließende Handle, einschließlich sichtbarer Benutzerfehler aufgrund fehlgeschlagener Versuche, Dateien zu lesen oder zu schreiben. Diese API ist nicht für die Verwendung als Ersatz oder Alternative für den SMB-Schließen vorgesehen.

Weitere Informationen finden Sie unter Schließen von Handles erzwingen.

ForceCloseAllHandlesAsync(Nullable<Boolean>, CancellationToken)

Der ForceCloseAllHandlesAsync(Nullable<Boolean>, CancellationToken) Vorgang schließt alle Handles, die in einem Verzeichnis oder einer Datei im Dienst geöffnet werden. Optional werden rekursiv schließende Handles für Unterressourcen unterstützt, wenn die Ressource ein Verzeichnis ist.

Diese API soll zusammen GetHandlesAsync(Nullable<Boolean>, CancellationToken) verwendet werden, um schließende Handles zu erzwingen, die Vorgänge blockieren, z. B. das Umbenennen eines Verzeichnisses. Diese Handles sind möglicherweise durch SMB-Clients kompromittiert oder verloren gegangen. Die API hat clientseitige Auswirkungen auf das zu schließende Handle, einschließlich sichtbarer Benutzerfehler aufgrund fehlgeschlagener Versuche, Dateien zu lesen oder zu schreiben. Diese API ist nicht für die Verwendung als Ersatz oder Alternative für den SMB-Schließen vorgesehen.

Weitere Informationen finden Sie unter Schließen von Handles erzwingen.

ForceCloseHandle(String, CancellationToken)

Der ForceCloseHandle(String, CancellationToken) Vorgang schließt ein Handle, das in einem Verzeichnis oder einer Datei im Dienst geöffnet wurde. Es unterstützt das Schließen eines einzelnen Handles, das von angegeben wird handleId.

Diese API soll zusammen GetHandles(Nullable<Boolean>, CancellationToken) verwendet werden, um schließende Handles zu erzwingen, die Vorgänge blockieren, z. B. das Umbenennen eines Verzeichnisses. Diese Handles sind möglicherweise durch SMB-Clients kompromittiert oder verloren gegangen. Die API hat clientseitige Auswirkungen auf das zu schließende Handle, einschließlich sichtbarer Benutzerfehler aufgrund fehlgeschlagener Versuche, Dateien zu lesen oder zu schreiben. Diese API ist nicht für die Verwendung als Ersatz oder Alternative für den SMB-Schließen vorgesehen.

Weitere Informationen finden Sie unter Schließen von Handles erzwingen.

ForceCloseHandleAsync(String, CancellationToken)

Der ForceCloseHandle(String, CancellationToken) Vorgang schließt ein Handle, das in einem Verzeichnis oder einer Datei im Dienst geöffnet wurde. Es unterstützt das Schließen eines einzelnen Handles, das von angegeben wird handleId.

Diese API soll zusammen GetHandlesAsync(Nullable<Boolean>, CancellationToken) verwendet werden, um schließende Handles zu erzwingen, die Vorgänge blockieren, z. B. das Umbenennen eines Verzeichnisses. Diese Handles sind möglicherweise durch SMB-Clients kompromittiert oder verloren gegangen. Die API hat clientseitige Auswirkungen auf das zu schließende Handle, einschließlich sichtbarer Benutzerfehler aufgrund fehlgeschlagener Versuche, Dateien zu lesen oder zu schreiben. Diese API ist nicht für die Verwendung als Ersatz oder Alternative für den SMB-Schließen vorgesehen.

Weitere Informationen finden Sie unter Schließen von Handles erzwingen.

GenerateSasUri(ShareFileSasPermissions, DateTimeOffset)

Gibt GenerateSasUri(ShareFileSasPermissions, DateTimeOffset) einen Uri zurück, der einen SAS-URI (Share Directory Service Shared Access Signature) basierend auf den übergebenen Clienteigenschaften und Parametern 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(ShareSasBuilder)

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

Informationen zur Überprüfung, ob der Client eine Service Sas-Instanz signieren kann, finden Sie unter CanGenerateSasUri.

Weitere Informationen finden Sie unter Erstellen einer Dienst-SAS

GetFileClient(String)

Erstellt ein neues ShareFileClient -Objekt, indem an das Ende von Uriangefügt fileName wird. Das neue ShareFileClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareDirectoryClient.

GetFilesAndDirectories(ShareDirectoryGetFilesAndDirectoriesOptions, CancellationToken)

Der GetFilesAndDirectoriesAsync(ShareDirectoryGetFilesAndDirectoriesOptions, CancellationToken) Vorgang gibt eine asynchrone Sequenz von Dateien und Unterverzeichnissen in diesem Verzeichnis zurück. Beim Auflisten der Dateien und Verzeichnisse können mehrere Anforderungen an den Dienst gesendet werden, während alle Werte abgerufen werden.

Weitere Informationen finden Sie unter Listenverzeichnisse und Dateien auf.

GetFilesAndDirectories(String, CancellationToken)

Der GetFilesAndDirectories(String, CancellationToken) Vorgang gibt eine asynchrone Sequenz von Dateien und Unterverzeichnissen in diesem Verzeichnis zurück. Beim Auflisten der Dateien und Verzeichnisse können mehrere Anforderungen an den Dienst gesendet werden, während alle Werte abgerufen werden.

Weitere Informationen finden Sie unter Listenverzeichnisse und Dateien auf.

GetFilesAndDirectoriesAsync(ShareDirectoryGetFilesAndDirectoriesOptions, CancellationToken)

Der GetFilesAndDirectoriesAsync(ShareDirectoryGetFilesAndDirectoriesOptions, CancellationToken) Vorgang gibt eine asynchrone Auflistung von Dateien und Unterverzeichnissen in diesem Verzeichnis zurück. Beim Auflisten der Dateien und Verzeichnisse können mehrere Anforderungen an den Dienst gesendet werden, während alle Werte abgerufen werden.

Weitere Informationen finden Sie unter Listenverzeichnisse und Dateien auf.

GetFilesAndDirectoriesAsync(String, CancellationToken)

Der GetFilesAndDirectoriesAsync(String, CancellationToken) Vorgang gibt eine asynchrone Auflistung von Dateien und Unterverzeichnissen in diesem Verzeichnis zurück. Beim Auflisten der Dateien und Verzeichnisse können mehrere Anforderungen an den Dienst gesendet werden, während alle Werte abgerufen werden.

Weitere Informationen finden Sie unter Listenverzeichnisse und Dateien auf.

GetHandles(Nullable<Boolean>, CancellationToken)

Der GetHandles(Nullable<Boolean>, CancellationToken) Vorgang gibt eine asynchrone Sequenz der geöffneten Handles in einem Verzeichnis oder einer Datei zurück. Das Aufzählen der Handles kann mehrere Anforderungen an den Dienst senden, während alle Werte abgerufen werden.

Weitere Informationen finden Sie unter Listenhandles.

GetHandlesAsync(Nullable<Boolean>, CancellationToken)

Der GetHandlesAsync(Nullable<Boolean>, CancellationToken) Vorgang gibt eine asynchrone Sequenz der geöffneten Handles in einem Verzeichnis oder einer Datei zurück. Das Aufzählen der Handles kann mehrere Anforderungen an den Dienst senden, während alle Werte abgerufen werden.

Weitere Informationen finden Sie unter Listenhandles.

GetParentDirectoryClientCore()

Erstellen Sie einen neuen ShareDirectoryClient , der auf diesen ShareFileClientübergeordneten Container verweist. Das neue ShareDirectoryClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareFileClient.

GetParentShareClientCore()

Erstellen Sie einen neuen ShareClient , der auf diesen ShareFileClientübergeordneten Container verweist. Das neue ShareClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareFileClient.

GetProperties(CancellationToken)

Der GetProperties(CancellationToken) Vorgang gibt alle benutzerdefinierten Metadaten und Systemeigenschaften für das angegebene Verzeichnis zurück. Die zurückgegebenen Daten enthalten nicht die Liste der Unterverzeichnisse oder Dateien des Verzeichnisses.

Weitere Informationen finden Sie unter Verzeichniseigenschaften abrufen.

GetPropertiesAsync(CancellationToken)

Der GetPropertiesAsync(CancellationToken) Vorgang gibt alle benutzerdefinierten Metadaten und Systemeigenschaften für das angegebene Verzeichnis zurück. Die zurückgegebenen Daten enthalten nicht die Liste der Unterverzeichnisse oder Dateien des Verzeichnisses.

Weitere Informationen finden Sie unter Verzeichniseigenschaften abrufen.

GetSubdirectoryClient(String)

Erstellt ein neues ShareDirectoryClient -Objekt, indem an das Ende von Uriangefügt subdirectoryName wird. Das neue ShareDirectoryClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareDirectoryClient.

Rename(String, ShareFileRenameOptions, CancellationToken)

Benennt ein Verzeichnis um. Diese API unterstützt das Umbenennen eines Verzeichnisses von einer Freigabe in eine andere oder zwischen Speicherkonten nicht.

RenameAsync(String, ShareFileRenameOptions, CancellationToken)

Benennt ein Verzeichnis um. Diese API unterstützt das Umbenennen eines Verzeichnisses von einer Freigabe in eine andere oder zwischen Speicherkonten nicht.

SetHttpHeaders(FileSmbProperties, String, CancellationToken)

Der SetHttpHeaders(FileSmbProperties, String, CancellationToken) Vorgang legt Systemeigenschaften für das Verzeichnis fest.

Weitere Informationen finden Sie unter Legen Sie Verzeichniseigenschaften fest.

SetHttpHeadersAsync(FileSmbProperties, String, CancellationToken)

Der SetHttpHeadersAsync(FileSmbProperties, String, CancellationToken) Vorgang legt Systemeigenschaften für das Verzeichnis fest.

Weitere Informationen finden Sie unter Festlegen von Verzeichniseigenschaften.

SetMetadata(IDictionary<String,String>, CancellationToken)

Der SetMetadata(IDictionary<String,String>, CancellationToken) Vorgang legt mindestens ein benutzerdefiniertes Name-Wert-Paar für das angegebene Verzeichnis fest.

Weitere Informationen finden Sie unter Legen Sie Verzeichnismetadaten fest.

SetMetadataAsync(IDictionary<String,String>, CancellationToken)

Der SetMetadataAsync(IDictionary<String,String>, CancellationToken) Vorgang legt mindestens ein benutzerdefiniertes Name-Wert-Paar für das angegebene Verzeichnis fest.

Weitere Informationen finden Sie unter Legen Sie Verzeichnismetadaten fest.

WithSnapshot(String)

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

Weitere Informationen finden Sie unter Momentaufnahmefreigabe.

Erweiterungsmethoden

GetParentDirectoryClient(ShareDirectoryClient)

Erstellen Sie einen neuen ShareDirectoryClient , der auf diesen ShareDirectoryClientübergeordneten Container verweist. Das neue ShareDirectoryClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareDirectoryClient.

GetParentShareClient(ShareDirectoryClient)

Erstellen Sie einen neuen ShareClient , der auf diesen ShareDirectoryClientübergeordneten Container verweist. Das neue ShareClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareDirectoryClient.

Gilt für: