Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Path-Klasse

 

Veröffentlicht: Oktober 2016

Führt Vorgänge für String-Instanzen aus, die Datei- oder Verzeichnispfadinformationen enthalten. Diese Vorgänge werden plattformübergreifend durchgeführt.

Um den .NET Framework-Quellcode für diesen Typ zu durchsuchen, finden Sie unter der Reference Source.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)


[ComVisibleAttribute(true)]
public static class Path

NameBeschreibung
System_CAPS_pubmethodSystem_CAPS_staticChangeExtension(String, String)

Ändert die Erweiterung einer Pfadzeichenfolge.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String, String)

Kombiniert zwei Zeichenfolgen zu einem Pfad.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String, String, String)

Kombiniert drei Zeichenfolgen zu einem Pfad.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String, String, String, String)

Kombiniert vier Zeichenfolgen zu einem Pfad.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String[])

Kombiniert ein Array von Zeichenfolgen zu einem Pfad.

System_CAPS_pubmethodSystem_CAPS_staticGetDirectoryName(String)

Gibt die Verzeichnisinformationen für die angegebene Pfadzeichenfolge zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetExtension(String)

Gibt die Erweiterung der angegebenen Pfadzeichenfolge zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetFileName(String)

Gibt den Dateinamen und die Erweiterung der angegebenen Pfadzeichenfolge zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetFileNameWithoutExtension(String)

Gibt den Dateinamen der angegebenen Pfadzeichenfolge ohne Erweiterung zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetFullPath(String)

Gibt den absoluten Pfad für die angegebene Pfadzeichenfolge zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetInvalidFileNameChars()

Ruft ein Array ab, das die Zeichen enthält, die in Dateinamen nicht zulässig sind.

System_CAPS_pubmethodSystem_CAPS_staticGetInvalidPathChars()

Ruft ein Array ab, das die Zeichen enthält, die in Pfadnamen nicht zulässig sind.

System_CAPS_pubmethodSystem_CAPS_staticGetPathRoot(String)

Ruft die Informationen über das Stammverzeichnis des angegebenen Pfads ab.

System_CAPS_pubmethodSystem_CAPS_staticGetRandomFileName()

Gibt einen zufälligen Ordnernamen oder Dateinamen zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetTempFileName()

Erstellt eine eindeutig benannte temporäre Datei auf dem Datenträger mit einer Größe von 0 Byte und gibt den vollständigen Pfad dieser Datei zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetTempPath()

Gibt den Pfad des temporären Ordners des aktuellen Benutzers zurück.

System_CAPS_pubmethodSystem_CAPS_staticHasExtension(String)

Bestimmt, ob ein Pfad eine Dateierweiterung enthält.

System_CAPS_pubmethodSystem_CAPS_staticIsPathRooted(String)

Ruft einen Wert ab, der angibt, ob die angegebene Pfadzeichenfolge einen Stamm enthält.

NameBeschreibung
System_CAPS_pubfieldSystem_CAPS_staticAltDirectorySeparatorChar

Stellt ein plattformspezifisches, alternatives Zeichen bereit, das zur Trennung von Verzeichnisebenen in einer Pfadzeichenfolge verwendet wird und eine hierarchische Dateisystemorganisation wiedergibt.

System_CAPS_pubfieldSystem_CAPS_staticDirectorySeparatorChar

Stellt ein plattformspezifisches Zeichen bereit, das zur Trennung von Verzeichnisebenen in einer Pfadzeichenfolge verwendet wird und eine hierarchische Dateisystemorganisation wiedergibt.

System_CAPS_pubfieldSystem_CAPS_staticInvalidPathChars

Veraltet. Stellt ein plattformspezifisches Array von Zeichen bereit, die nicht in Pfadzeichenfolgenargumenten angegeben werden können, die an Member der Path-Klasse übergeben werden.

System_CAPS_pubfieldSystem_CAPS_staticPathSeparator

Ein plattformspezifisches Trennzeichen, das zur Trennung von Pfadzeichenfolgen in Umgebungsvariablen verwendet wird.

System_CAPS_pubfieldSystem_CAPS_staticVolumeSeparatorChar

Stellt ein plattformspezifisches Volumetrennzeichen bereit.

System_CAPS_noteHinweis

Die .NET Framework-Quellcodes für diesen Typ finden Sie unter der Reference Source. Sie können den Quellcode online Durchsuchen, Referenz für die Offlineanzeige herunterladen und schrittweise durchlaufen (inklusive Patches und Updates) während des Debuggens; see instructions.

Das .NET Framework unterstützt keine direkten Zugriff auf physische Datenträger über Pfade, die Gerätenamen wie z. B. "\\.\PHYSICALDRIVE0" sind.

Ein Pfad ist eine Zeichenfolge, die den Speicherort einer Datei oder Verzeichnis bereitstellt. Ein Pfad zeigt nicht notwendigerweise an einen Speicherort auf dem Datenträger; ein Pfad kann z. B. an einem Speicherort im Arbeitsspeicher oder auf einem Gerät zuordnen. Das genaue Format eines Pfads wird von der aktuellen Plattform bestimmt. Beispielsweise kann auf einigen Systemen ein Pfad mit einem Buchstaben Laufwerk oder Volume beginnen, während dieses Element nicht in anderen Systemen vorhanden ist. Auf einigen Systemen können Dateipfade Extensions enthalten den Typ des in der Datei gespeicherten Informationen an. Das Format der Erweiterung ist plattformabhängig. z. B. einige Systeme Erweiterungen auf drei Zeichen beschränkt und andere nicht. Die aktuelle Plattform bestimmt auch den Satz von Zeichen verwendet, um die Elemente eines Pfads zu trennen und die Gruppe von Zeichen, die bei der Angabe von Pfaden verwendet werden kann. Aufgrund dieser Unterschiede sind die Felder von der Path sowie das genaue Verhalten einiger Member der Klasse die Path Klasse hängen von der Plattform ab.

Ein Pfad kann absolute oder relative Speicherortinformationen enthalten. Absolute Pfade geben einen Speicherort vollständig an: die Datei oder das Verzeichnis eindeutig unabhängig von der aktuellen Position identifiziert werden kann. Relative Pfade geben einen Speicherort teilweise an: der aktuelle Speicherort dient als Ausgangspunkt beim Suchen nach einer Datei mit einem relativen Pfad angegeben. Rufen Sie zum Bestimmen des aktuellen Verzeichnisses Directory.GetCurrentDirectory auf.

Die meisten Mitglieder 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, wie z. B. ändern ChangeExtension, wirken sich nicht auf den Namen der Dateien im Dateisystem. Path Mitglieder, jedoch überprüft den Inhalt einer angegebenen Pfadzeichenfolge, und löst eine ArgumentException -Ausnahme aus, wenn die Zeichenfolge Zeichen, die nicht in Pfadzeichenfolgen gültig sind enthält, wie in den von zurückgegebenen Zeichen definiert die GetInvalidPathChars Methode. Auf Windows-basierten desktop-Plattformen können z. B. ungültige Pfadzeichen Anführungszeichen ("), kleiner als (<), größer als (>), Pipe (|), Rücktastenzeichen (\b), Null (\0) und Unicode-Zeichen 16 bis 18 bis 20 bis 25 enthalten.

Die Mitglieder der Path -Klasse können Sie schnell und einfach allgemeine Vorgänge wie z. B. bestimmen, ob eine Erweiterung eines Pfadsegments ist, und Kombinieren von zwei Zeichenfolgen in einem Pfad ausführen.

Alle Mitglieder der Path -Klasse sind statisch und können daher aufgerufen werden, ohne eine Instanz eines Pfads.

System_CAPS_noteHinweis

Bei Membern, die einen Pfad als Eingabezeichenfolge akzeptieren, diesem Pfad muss wohlgeformt sein oder eine Ausnahme ausgelöst. Wenn ein Pfad vollqualifiziert, aber mit einem Leerzeichen beginnt, wird der Pfad beispielsweise nicht in den Methoden der Klasse gekürzt. Aus diesem Grund der Pfad ist ungültig, und eine Ausnahme ausgelöst. Auf ähnliche Weise kann keinen Pfad oder eine Kombination von Pfaden zweimal vollqualifiziert werden. "C:\temp c:\windows" löst beispielsweise auch in den meisten Fällen eine Ausnahme aus. Stellen Sie sicher, dass die Pfade wohlgeformt sind, wenn Sie Methoden verwenden, die eine Pfadzeichenfolge akzeptieren.

Bei Membern, die einen Pfad akzeptieren, kann der Pfad zu einer Datei oder nur ein Verzeichnis verweisen. Der angegebene Pfad kann auch einen relativen Pfad oder einen Universal Naming Convention (UNC)-Pfad für einen Server und Freigabe 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 all diese Operationen mit Zeichenfolgen durchgeführt werden, ist es unmöglich, stellen Sie sicher, dass die Ergebnisse in allen Szenarien gültig sind. Zum Beispiel die GetExtension Methode analysiert eine Zeichenfolge, die an sie übergeben werden, und gibt die Erweiterung aus dieser Zeichenfolge zurück. Dies bedeutet jedoch nicht, dass eine Datei mit dieser Erweiterung auf dem Datenträger vorhanden ist.

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

Im folgenden Codebeispiel veranschaulicht einige der wichtigsten Elemente der Path Klasse.

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

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: