Path-Klasse

In .NET Framework wird der direkte Zugriff auf physische Datenträger über Pfade, bei denen es sich um Gerätenamen handelt nicht unterstützt, , z. B. "\\. \PHYSICALDRIVE0 ".

Ein Pfad ist eine Zeichenfolge, die den Speicherort einer Datei oder eines Verzeichnisses angibt. Ein Pfad zeigt nicht unbedingt auf einen Speicherort auf der Festplatte, er kann beispielsweise auch einem Speicherort im Arbeitsspeicher oder auf einem Gerät zugeordnet sein. Das genaue Format eines Pfades wird durch die aktuelle Plattform bestimmt. Beispielsweise kann auf einigen Systemen ein Pfad mit einem Laufwerk- oder Volumebuchstaben beginnen, während dieses Element auf anderen Systemen nicht vorhanden ist. Auf einigen Systemen können Dateipfade Erweiterungen enthalten, die den Typ der in der Datei gespeicherten Informationen angeben. Das Format einer Dateinamenerweiterung ist von der Plattform abhängig. Einige Systeme beschränken beispielsweise Erweiterungen auf drei Zeichen, andere nicht. Die aktuelle Plattform bestimmt auch die Gruppe von Zeichen, die für die Trennung der Elemente eines Pfades verwendet wird, sowie die Gruppe von Zeichen, die bei der Angabe von Pfaden nicht verwendet werden kann. Aufgrund dieser Unterschiede sind die Felder der Path-Klasse sowie das genaue Verhalten einiger Member der Path-Klasse plattformabhängig.

Ein Pfad kann absolute oder relative Informationen über den Speicherort enthalten. Absolute Pfade geben einen Speicherort vollständig an: Die Datei oder das Verzeichnis kann unabhängig von der aktuellen Position eindeutig identifiziert werden. Relative Pfade geben einen Speicherort teilweise an: Die aktuelle Position wird als Startpunkt bei der Suche nach einer Datei verwendet, die durch einen relativen Pfad angegeben ist. Zum Bestimmen des aktuellen Verzeichnisses rufen Sie Directory.GetCurrentDirectory auf.

Die meisten Member der Path-Klasse interagieren nicht mit dem Dateisystem und überprüfen das Vorhandensein der von einer Pfadzeichenfolge angegebenen Datei nicht. Path-Klassenmember, die eine Pfadzeichenfolge, z. B. ChangeExtension, ändern, haben keine Auswirkungen auf die Namen der Dateien im Dateisystem. Path-Member überprüfen jedoch den Inhalt einer angegebenen Pfadzeichenfolge, und löst einen ArgumentException aus, wenn die Zeichenfolge Zeichen enthält, die in Pfadzeichenfolgen nicht gültig sind, wie in InvalidPathChars definiert. Auf Windows-basierten Desktopplattformen können beispielsweise die folgenden Zeichen für Pfadnamen ungültig sein: Anführungszeichen ("), Kleiner-als-Zeichen (<), Größer-als-Zeichen (>), der senkrechte Strich (|), Rücktastenzeichen (\b), NULL (\0), Tabulator (\t) und die Unicode-Zeichen 16 bis18 sowie 20 bis 25.

Mit Membern der Path-Klasse können Sie schnell und einfach allgemeine Operationen durchführen, z. B. bestimmen, ob eine Dateinamenerweiterung Teil eines Pfades ist, oder zwei Zeichenfolgen zu einem Pfadnamen kombinieren.

Alle Member der Path-Klasse sind statisch und können daher aufgerufen werden, ohne über eine Instanz eines Pfades verfügen zu müssen.

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.

Da alle diese Operationen mit Zeichenfolgen durchgeführt werden, kann nicht sichergestellt werden, dass die Ergebnisse in allen Szenarien gültig sind. Die GetExtension-Methode analysiert beispielsweise eine ihr übergebene Zeichenfolge und gibt die Erweiterung aus dieser Zeichenfolge zurück. Dies bedeutet jedoch nicht, dass auf dem Datenträger eine Datei mit dieser Erweiterung vorhanden ist.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Im folgenden Codebeispiel werden einige der wichtigsten Member der Path-Klasse veranschaulicht.

using System;
using System.IO;

class Test 
{
	
    public static void Main() 
    {
        string path1 = @"c:\temp\MyTest.txt";
        string path2 = @"c:\temp\MyTest";
        string path3 = @"temp";

        if (Path.HasExtension(path1)) 
        {
            Console.WriteLine("{0} has an extension.", path1);
        }

        if (!Path.HasExtension(path2)) 
        {
            Console.WriteLine("{0} has no extension.", path2);
        }

        if (!Path.IsPathRooted(path3)) 
        {
            Console.WriteLine("The string {0} contains no root information.", path3);
        }

        Console.WriteLine("The full path of {0} is {1}.", path3, Path.GetFullPath(path3));
        Console.WriteLine("{0} is the location for temporary files.", Path.GetTempPath());
        Console.WriteLine("{0} is a file available for use.", Path.GetTempFileName());

        /* This code produces output similar to the following:
         * c:\temp\MyTest.txt has an extension.
         * c:\temp\MyTest has no extension.
         * The string temp contains no root information.
         * The full path of temp is D:\Documents and Settings\cliffc\My Documents\Visual Studio 2005\Projects\ConsoleApplication2\ConsoleApplication2\bin\Debug\temp.
         * D:\Documents and Settings\cliffc\Local Settings\Temp\8\ is the location for temporary files.
         * D:\Documents and Settings\cliffc\Local Settings\Temp\8\tmp3D.tmp is a file available for use.
         */
    }
}

.NET Framework

.NET Framework Client Profile

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

Referenz

Weitere Ressourcen