Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
DirectoryInfo-Klasse
Macht Instanzmethoden zum Erstellen, Verschieben und Auflisten in Verzeichnissen und Unterverzeichnissen verfügbar. Diese Klasse kann nicht vererbt werden.
Assembly: mscorlib (in mscorlib.dll)
Der DirectoryInfo-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
DirectoryInfo | Initialisiert eine neue Instanz der DirectoryInfo-Klasse im angegebenen Pfad. |
| Name | Beschreibung | |
|---|---|---|
|
Attributes | Ruft die Attribute für die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diese fest. (Von FileSystemInfo geerbt.) |
|
CreationTime | Ruft den Erstellungszeitpunkt der aktuellen Datei oder des aktuellen Verzeichnisses ab oder legt diesen fest. (Von FileSystemInfo geerbt.) |
|
CreationTimeUtc | Ruft die Erstellungszeit der aktuellen Datei oder des aktuellen Verzeichnisses im UTC-Format (Coordinated Universal Time) ab oder legt diese fest. (Von FileSystemInfo geerbt.) |
|
Exists | Ruft einen Wert ab, der angibt, ob das Verzeichnis vorhanden ist. (Überschreibt FileSystemInfo.Exists.) |
|
Extension | Ruft die Zeichenfolge ab, die den Erweiterungsteil der Datei darstellt. (Von FileSystemInfo geerbt.) |
|
FullName | Ruft den vollständigen Pfad des Verzeichnisses oder der Datei ab. (Von FileSystemInfo geerbt.) |
|
LastAccessTime | Ruft den Zeitpunkt des letzten Zugriffs auf die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diesen fest. (Von FileSystemInfo geerbt.) |
|
LastAccessTimeUtc | Ruft den Zeitpunkt des letzten Zugriffs auf die aktuelle Datei bzw. das aktuelle Verzeichnis im UTC-Format (Coordinated Universal Time) ab oder legt diesen fest. (Von FileSystemInfo geerbt.) |
|
LastWriteTime | Ruft den Zeitpunkt des letzten Schreibzugriffs auf die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diesen fest. (Von FileSystemInfo geerbt.) |
|
LastWriteTimeUtc | Ruft den Zeitpunkt des letzten Schreibens in die aktuelle Datei oder das aktuelle Verzeichnis im UTC-Format (Coordinated Universal Time) ab oder legt diesen fest. (Von FileSystemInfo geerbt.) |
|
Name | Ruft den Namen dieser DirectoryInfo-Instanz ab. (Überschreibt FileSystemInfo.Name.) |
|
Parent | Ruft das übergeordnete Verzeichnis eines angegebenen Unterverzeichnisses ab. |
|
Root | Ruft den Teil mit dem Stammverzeichnis eines Pfads ab. |
| Name | Beschreibung | |
|---|---|---|
|
Create() | Erstellt ein Verzeichnis. |
|
Create(DirectorySecurity) | Erstellt mithilfe eines DirectorySecurity-Objekts ein Verzeichnis. |
|
CreateObjRef | Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Von MarshalByRefObject geerbt.) |
|
CreateSubdirectory(String) | Erstellt ein oder mehrere Unterverzeichnisse im angegebenen Pfad. Der angegebene Pfad kann zu dieser Instanz der DirectoryInfo-Klasse relativ sein. |
|
CreateSubdirectory(String, DirectorySecurity) | Erstellt ein oder mehrere Unterverzeichnisse im angegebenen Pfad mit der angegebenen Sicherheit. Der angegebene Pfad kann zu dieser Instanz der DirectoryInfo-Klasse relativ sein. |
|
Delete() | Löscht dieses DirectoryInfo, wenn es leer ist. (Überschreibt FileSystemInfo.Delete().) |
|
Delete(Boolean) | Löscht diese Instanz von DirectoryInfo und gibt an, ob Unterverzeichnisse und Dateien gelöscht werden sollen. |
|
EnumerateDirectories() | Gibt eine aufzählbare Auflistung von Verzeichnisinformationen im aktuellen Verzeichnis zurück. |
|
EnumerateDirectories(String) | Gibt eine aufzählbare Auflistung von Verzeichnisinformationen zurück, die einem angegebenen Suchmuster entsprechen. |
|
EnumerateDirectories(String, SearchOption) | Gibt eine aufzählbare Auflistung von Verzeichnisinformationen zurück, die einem angegebenen Suchmuster und einer angegebenen Option zum Durchsuchen von Unterverzeichnissen entspricht. |
|
EnumerateFiles() | Gibt eine aufzählbare Auflistung von Dateiinformationen im aktuellen Verzeichnis zurück. |
|
EnumerateFiles(String) | Gibt eine aufzählbare Auflistung von Dateiinformationen zurück, die einem Suchmuster entsprechen. |
|
EnumerateFiles(String, SearchOption) | Gibt eine aufzählbare Auflistung von Dateiinformationen zurück, die einem angegebenen Suchmuster und einer angegebenen Option zum Durchsuchen von Unterverzeichnissen entspricht. |
|
EnumerateFileSystemInfos() | Gibt eine aufzählbare Auflistung von Systeminformationen im aktuellen Verzeichnis zurück. |
|
EnumerateFileSystemInfos(String) | Gibt eine aufzählbare Auflistung von Dateisysteminformationen zurück, die einem angegebenen Suchmuster entsprechen. |
|
EnumerateFileSystemInfos(String, SearchOption) | Gibt eine aufzählbare Auflistung von Dateisysteminformationen zurück, die einem angegebenen Suchmuster und einer angegebenen Option zum Durchsuchen von Unterverzeichnissen entspricht. |
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
Finalize | Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.) |
|
GetAccessControl() | Ruft ein DirectorySecurity-Objekt ab, das die Einträge in der Zugriffssteuerungsliste für das Verzeichnis kapselt, das vom aktuellen DirectoryInfo-Objekt beschrieben wird. |
|
GetAccessControl(AccessControlSections) | Ruft ein DirectorySecurity-Objekt ab, das den angegebenen Typ der Einträge in der Zugriffssteuerungsliste für das Verzeichnis kapselt, das vom aktuellen DirectoryInfo-Objekt beschrieben wird. |
|
GetDirectories() | Gibt die Unterverzeichnisse des aktuellen Verzeichnisses zurück. |
|
GetDirectories(String) | Gibt ein Array von Verzeichnissen im aktuellen DirectoryInfo zurück, die den angegebenen Suchkriterien entsprechen. |
|
GetDirectories(String, SearchOption) | Gibt ein Array von Verzeichnissen im aktuellen DirectoryInfo zurück, die den angegebenen Suchkriterien entsprechen. Anhand eines Werts wird bestimmt, ob in Unterverzeichnissen gesucht wird. |
|
GetFiles() | Gibt eine Dateiliste des aktuellen Verzeichnisses zurück. |
|
GetFiles(String) | Gibt eine Dateiliste des aktuellen Verzeichnisses zurück, das dem angegebenen Suchmuster entspricht. |
|
GetFiles(String, SearchOption) | Gibt eine Dateiliste des aktuellen Verzeichnisses zurück, das dem angegebenen Suchmuster entspricht. Anhand eines Werts wird bestimmt, ob in Unterverzeichnissen gesucht wird. |
|
GetFileSystemInfos() | Gibt ein Array von stark typisierten FileSystemInfo-Einträgen zurück, das alle Dateien und Unterverzeichnisse in einem Verzeichnis darstellt. |
|
GetFileSystemInfos(String) | Ruft ein Array von stark typisierten FileSystemInfo-Objekten ab, das die Dateien und Unterverzeichnisse darstellt, die den angegebenen Suchkriterien entsprechen. |
|
GetFileSystemInfos(String, SearchOption) | Ruft ein Array von FileSystemInfo-Objekten ab, die die Dateien und Unterverzeichnisse darstellen, die den angegebenen Suchkriterien entsprechen. |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetLifetimeService | Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.) |
|
GetObjectData | Legt das SerializationInfo-Objekt mit dem Dateinamen und zusätzlichen Informationen zur Ausnahme fest. (Von FileSystemInfo geerbt.) |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
InitializeLifetimeService | Ruft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.) |
|
MemberwiseClone() | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
MemberwiseClone(Boolean) | Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Von MarshalByRefObject geerbt.) |
|
MoveTo | Verschiebt eine DirectoryInfo-Instanz und deren Inhalt in einen neuen Pfad. |
|
Refresh | Aktualisiert den Zustand des Objekts. (Von FileSystemInfo geerbt.) |
|
SetAccessControl | Wendet von einem DirectorySecurity-Objekt beschriebene Einträge in Zugriffssteuerungslisten auf das Verzeichnis an, das vom aktuellen DirectoryInfo-Objekt beschrieben wird. |
|
ToString | Gibt den ursprünglichen Pfad zurück, der vom Benutzer übergeben wurde. (Überschreibt Object.ToString().) |
| Name | Beschreibung | |
|---|---|---|
|
FullPath | Stellt den vollqualifizierten Pfad des Verzeichnisses oder der Datei dar. (Von FileSystemInfo geerbt.) |
|
OriginalPath | Der ursprünglich vom Benutzer angegebene Pfad, relativ oder absolut. (Von FileSystemInfo geerbt.) |
Verwenden Sie die DirectoryInfo-Klasse für typische Operationen, z. B. das Kopieren, Verschieben, Umbenennen, Erstellen und Löschen von Dateien.
Wenn Sie ein Objekt mehrmals wiederverwenden, verwenden Sie statt der entsprechenden statischen Methoden der Directory-Klasse die Instanzmethode von DirectoryInfo, da eine Sicherheitsüberprüfung nicht immer erforderlich ist.
Hinweis
|
|---|
|
Bei Membern, die einen Pfad als Eingabezeichenfolge akzeptieren, muss dieser Pfad wohlgeformt sein. Andernfalls wird eine Ausnahme ausgelöst. Wenn beispielsweise ein Pfad voll gekennzeichnet ist, aber mit einem Leerzeichen beginnt, wird der Pfad in Methoden der Klasse nicht gekürzt. Daher ist der Pad falsch formatiert, und es wird eine Ausnahme ausgelöst. Ebenso kann ein Pfad oder eine Kombination von Pfaden nicht zweimal voll gekennzeichnet werden. Auch "c:\temp c:\windows" löst beispielsweise in den meisten Fällen eine Ausnahme aus. Bei der Verwendung von Methoden, die eine Pfadzeichenfolge akzeptieren, müssen Sie sicherstellen, dass die Pfade wohlgeformt sind. |
Bei Membern, die einen Pfad akzeptieren, kann der Pfad auf eine Datei oder nur auf ein Verzeichnis verweisen. Der angegebene Pfad kann auch auf einen relativen Pfad oder auf einen UNC-Pfad (Universal Naming Convention) für einen Server- und Freigabenamen verweisen. Beispielsweise sind alle folgenden Pfade zulässig:
-
"c:\\MyDir\\MyFile.txt" in C# oder "c:\MyDir\MyFile.txt" in Visual Basic.
-
"c:\\MyDir" in C# oder "c:\MyDir" in Visual Basic.
-
"MyDir\\MySubdir" in C# oder "MyDir\MySubDir" in Visual Basic.
-
"\\\\MyServer\\MyShare" in C# oder "\\MyServer\MyShare" in Visual Basic.
Standardmäßig wird allen Benutzern voller Lese- und Schreibzugriff für alle neuen Verzeichnisse gewährt.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Das folgende Beispiel veranschaulicht einige der wichtigsten Member der DirectoryInfo-Klasse.
using System; using System.IO; class Test { public static void Main() { // Specify the directories you want to manipulate. DirectoryInfo di = new DirectoryInfo(@"c:\MyDir"); try { // Determine whether the directory exists. if (di.Exists) { // Indicate that the directory already exists. Console.WriteLine("That path exists already."); return; } // Try to create the directory. di.Create(); Console.WriteLine("The directory was created successfully."); // Delete the directory. di.Delete(); Console.WriteLine("The directory was deleted successfully."); } catch (Exception e) { Console.WriteLine("The process failed: {0}", e.ToString()); } finally {} } }
Im folgenden Beispiel wird veranschaulicht, wie ein Verzeichnis und sein Inhalt kopiert werden.
using System; using System.IO; class CopyDir { public static void CopyAll(DirectoryInfo source, DirectoryInfo target) { if (source.FullName.ToLower() == target.FullName.ToLower()) { return; } // Check if the target directory exists, if not, create it. if (Directory.Exists(target.FullName) == false) { Directory.CreateDirectory(target.FullName); } // Copy each file into it's new directory. foreach (FileInfo fi in source.GetFiles()) { Console.WriteLine(@"Copying {0}\{1}", target.FullName, fi.Name); fi.CopyTo(Path.Combine(target.ToString(), fi.Name), true); } // Copy each subdirectory using recursion. foreach (DirectoryInfo diSourceSubDir in source.GetDirectories()) { DirectoryInfo nextTargetSubDir = target.CreateSubdirectory(diSourceSubDir.Name); CopyAll(diSourceSubDir, nextTargetSubDir); } } public static void Main() { string sourceDirectory = @"c:\sourceDirectory"; string targetDirectory = @"c:\targetDirectory"; DirectoryInfo diSource = new DirectoryInfo(sourceDirectory); DirectoryInfo diTarget = new DirectoryInfo(targetDirectory); CopyAll(diSource, diTarget); } // Output will vary based on the contents of the source directory. }
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Hinweis