Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DirectoryInfo-Klasse

Macht Instanzmethoden zum Erstellen, Verschieben und Auflisten in Verzeichnissen und Unterverzeichnissen verfügbar. Diese Klasse kann nicht vererbt werden.

System.Object
  System.MarshalByRefObject
    System.IO.FileSystemInfo
      System.IO.DirectoryInfo

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)
[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class DirectoryInfo : FileSystemInfo

Der DirectoryInfo-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode Unterstützt von XNA Framework DirectoryInfo Initialisiert eine neue Instanz der DirectoryInfo-Klasse im angegebenen Pfad.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft Unterstützt von XNA Framework Attributes Ruft die Attribute für die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diese fest. (Von FileSystemInfo geerbt.)
Öffentliche Eigenschaft Unterstützt von XNA Framework CreationTime Ruft den Erstellungszeitpunkt der aktuellen Datei oder des aktuellen Verzeichnisses ab oder legt diesen fest. (Von FileSystemInfo geerbt.)
Öffentliche Eigenschaft 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.)
Öffentliche Eigenschaft Unterstützt von XNA Framework Exists Ruft einen Wert ab, der angibt, ob das Verzeichnis vorhanden ist. (Überschreibt FileSystemInfo.Exists.)
Öffentliche Eigenschaft Unterstützt von XNA Framework Extension Ruft die Zeichenfolge ab, die den Erweiterungsteil der Datei darstellt. (Von FileSystemInfo geerbt.)
Öffentliche Eigenschaft Unterstützt von XNA Framework FullName Ruft den vollständigen Pfad des Verzeichnisses oder der Datei ab. (Von FileSystemInfo geerbt.)
Öffentliche Eigenschaft Unterstützt von XNA Framework LastAccessTime Ruft den Zeitpunkt des letzten Zugriffs auf die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diesen fest. (Von FileSystemInfo geerbt.)
Öffentliche Eigenschaft 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.)
Öffentliche Eigenschaft Unterstützt von XNA Framework LastWriteTime Ruft den Zeitpunkt des letzten Schreibzugriffs auf die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diesen fest. (Von FileSystemInfo geerbt.)
Öffentliche Eigenschaft 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.)
Öffentliche Eigenschaft Unterstützt von XNA Framework Name Ruft den Namen dieser DirectoryInfo-Instanz ab. (Überschreibt FileSystemInfo.Name.)
Öffentliche Eigenschaft Unterstützt von XNA Framework Parent Ruft das übergeordnete Verzeichnis eines angegebenen Unterverzeichnisses ab.
Öffentliche Eigenschaft Unterstützt von XNA Framework Root Ruft den Teil mit dem Stammverzeichnis eines Pfads ab.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Unterstützt von XNA Framework Create() Erstellt ein Verzeichnis.
Öffentliche Methode Create(DirectorySecurity) Erstellt mithilfe eines DirectorySecurity-Objekts ein Verzeichnis.
Öffentliche Methode 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.)
Öffentliche Methode Unterstützt von XNA Framework CreateSubdirectory(String) Erstellt ein oder mehrere Unterverzeichnisse im angegebenen Pfad. Der angegebene Pfad kann zu dieser Instanz der DirectoryInfo-Klasse relativ sein.
Öffentliche Methode 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.
Öffentliche Methode Unterstützt von XNA Framework Delete() Löscht dieses DirectoryInfo, wenn es leer ist. (Überschreibt FileSystemInfo.Delete().)
Öffentliche Methode Unterstützt von XNA Framework Delete(Boolean) Löscht diese Instanz von DirectoryInfo und gibt an, ob Unterverzeichnisse und Dateien gelöscht werden sollen.
Öffentliche Methode EnumerateDirectories() Gibt eine aufzählbare Auflistung von Verzeichnisinformationen im aktuellen Verzeichnis zurück.
Öffentliche Methode EnumerateDirectories(String) Gibt eine aufzählbare Auflistung von Verzeichnisinformationen zurück, die einem angegebenen Suchmuster entsprechen.
Öffentliche Methode 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.
Öffentliche Methode EnumerateFiles() Gibt eine aufzählbare Auflistung von Dateiinformationen im aktuellen Verzeichnis zurück.
Öffentliche Methode EnumerateFiles(String) Gibt eine aufzählbare Auflistung von Dateiinformationen zurück, die einem Suchmuster entsprechen.
Öffentliche Methode 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.
Öffentliche Methode EnumerateFileSystemInfos() Gibt eine aufzählbare Auflistung von Systeminformationen im aktuellen Verzeichnis zurück.
Öffentliche Methode EnumerateFileSystemInfos(String) Gibt eine aufzählbare Auflistung von Dateisysteminformationen zurück, die einem angegebenen Suchmuster entsprechen.
Öffentliche Methode 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.
Öffentliche Methode Unterstützt von XNA Framework Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Unterstützt von XNA Framework 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.)
Öffentliche Methode 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.
Öffentliche Methode 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.
Öffentliche Methode Unterstützt von XNA Framework GetDirectories() Gibt die Unterverzeichnisse des aktuellen Verzeichnisses zurück.
Öffentliche Methode Unterstützt von XNA Framework GetDirectories(String) Gibt ein Array von Verzeichnissen im aktuellen DirectoryInfo zurück, die den angegebenen Suchkriterien entsprechen.
Öffentliche Methode 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.
Öffentliche Methode Unterstützt von XNA Framework GetFiles() Gibt eine Dateiliste des aktuellen Verzeichnisses zurück.
Öffentliche Methode Unterstützt von XNA Framework GetFiles(String) Gibt eine Dateiliste des aktuellen Verzeichnisses zurück, das dem angegebenen Suchmuster entspricht.
Öffentliche Methode 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.
Öffentliche Methode Unterstützt von XNA Framework GetFileSystemInfos() Gibt ein Array von stark typisierten FileSystemInfo-Einträgen zurück, das alle Dateien und Unterverzeichnisse in einem Verzeichnis darstellt.
Öffentliche Methode Unterstützt von XNA Framework GetFileSystemInfos(String) Ruft ein Array von stark typisierten FileSystemInfo-Objekten ab, das die Dateien und Unterverzeichnisse darstellt, die den angegebenen Suchkriterien entsprechen.
Öffentliche Methode GetFileSystemInfos(String, SearchOption) Ruft ein Array von FileSystemInfo-Objekten ab, die die Dateien und Unterverzeichnisse darstellen, die den angegebenen Suchkriterien entsprechen.
Öffentliche Methode Unterstützt von XNA Framework GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetLifetimeService Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.)
Öffentliche Methode GetObjectData Legt das SerializationInfo-Objekt mit dem Dateinamen und zusätzlichen Informationen zur Ausnahme fest. (Von FileSystemInfo geerbt.)
Öffentliche Methode Unterstützt von XNA Framework GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche Methode InitializeLifetimeService Ruft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.)
Geschützte Methode Unterstützt von XNA Framework MemberwiseClone() Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte Methode MemberwiseClone(Boolean) Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Von MarshalByRefObject geerbt.)
Öffentliche Methode Unterstützt von XNA Framework MoveTo Verschiebt eine DirectoryInfo-Instanz und deren Inhalt in einen neuen Pfad.
Öffentliche Methode Unterstützt von XNA Framework Refresh Aktualisiert den Zustand des Objekts. (Von FileSystemInfo geerbt.)
Öffentliche Methode SetAccessControl Wendet von einem DirectorySecurity-Objekt beschriebene Einträge in Zugriffssteuerungslisten auf das Verzeichnis an, das vom aktuellen DirectoryInfo-Objekt beschrieben wird.
Öffentliche Methode Unterstützt von XNA Framework ToString Gibt den ursprünglichen Pfad zurück, der vom Benutzer übergeben wurde. (Überschreibt Object.ToString().)
Zum Seitenanfang
  Name Beschreibung
Geschütztes Feld Unterstützt von XNA Framework FullPath Stellt den vollqualifizierten Pfad des Verzeichnisses oder der Datei dar. (Von FileSystemInfo geerbt.)
Geschütztes Feld Unterstützt von XNA Framework OriginalPath Der ursprünglich vom Benutzer angegebene Pfad, relativ oder absolut. (Von FileSystemInfo geerbt.)
Zum Seitenanfang

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 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.
}


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

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.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ