Path Klasse

Definition

public ref class Path abstract sealed

public ref class Path sealed

public static class Path

public sealed class Path

[System.Runtime.InteropServices.ComVisible(true)]
public static class Path

type Path = class

[<System.Runtime.InteropServices.ComVisible(true)>]
type Path = class

Public Class Path

Public NotInheritable Class Path

Vererbung

Object

Path

Attribute

ComVisibleAttribute

Beispiele

Im folgenden Beispiel werden einige der Standard Member der Path -Klasse veranschaulicht.

using namespace System;
using namespace System::IO;
int 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() );
   Console::WriteLine( "\r\nThe set of invalid characters in a path is:" );
   Console::WriteLine( "(Note that the wildcard characters '*' and '?' are not invalid.):" );
   Collections::IEnumerator^ myEnum = Path::InvalidPathChars->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c =  *safe_cast<Char^>(myEnum->Current);
      Console::WriteLine( c );
   }
}

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

Imports System.IO

Public Class Test

    Public Shared Sub Main()
        Dim path1 As String = "c:\temp\MyTest.txt"
        Dim path2 As String = "c:\temp\MyTest"
        Dim path3 As String = "temp"

        If Path.HasExtension(path1) Then
            Console.WriteLine("{0} has an extension.", path1)
        End If

        If Path.HasExtension(path2) = False Then
            Console.WriteLine("{0} has no extension.", path2)
        End If

        If Path.IsPathRooted(path3) = False Then
            Console.WriteLine("The string {0} contains no root information.", path3)
        End If

        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.

    End Sub
End Class

Hinweise

Ein Pfad ist eine Zeichenfolge, die den Speicherort einer Datei oder eines Verzeichnisses angibt. Ein Pfad verweist nicht unbedingt auf einen Speicherort auf dem Datenträger. Beispielsweise kann ein Pfad einem Speicherort im Arbeitsspeicher oder auf einem Gerät zugeordnet werden. Das genaue Format eines Pfads wird von der aktuellen Plattform bestimmt. Auf einigen Systemen kann ein Pfad beispielsweise mit einem Laufwerks- oder Volumebuchstaben beginnen, während dieses Element in 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 plattformabhängig. Beispielsweise beschränken einige Systeme Erweiterungen auf drei Zeichen (z. B. FAT16, die häufig für kleinere Flashspeicher und ältere Versionen von ISO 9660 verwendet werden, die auf optischen Medien verwendet werden), andere nicht. Die aktuelle Plattform bestimmt auch den Satz von Zeichen, die zum Trennen der Elemente eines Pfads verwendet werden, und den Satz von Zeichen, die beim Angeben von Pfaden nicht verwendet werden können. 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 Standortinformationen enthalten. Absolute Pfade geben vollständig einen Speicherort an: Die Datei oder das Verzeichnis kann unabhängig vom aktuellen Speicherort eindeutig identifiziert werden. Relative Pfade geben einen teiligen Speicherort an: Der aktuelle Speicherort wird als Ausgangspunkt beim Suchen einer Datei verwendet, die mit einem relativen Pfad angegeben ist. Rufen Sie zum Ermitteln des aktuellen Verzeichnisses auf Directory.GetCurrentDirectory.

.NET Core 1.1 und höhere Versionen und .NET Framework 4.6.2 und höher unterstützen auch den Zugriff auf Dateisystemobjekte, die Gerätenamen sind, z. B. "\\?\C:\".

Weitere Informationen zu Dateiformaten unter Windows finden Sie unter Dateipfadformate auf Windows-Systemen.

Die meisten Member der Path -Klasse interagieren nicht mit dem Dateisystem und überprüfen nicht, ob die durch eine Pfadzeichenfolge angegebene Datei vorhanden ist. Path Klassenmember, die eine Pfadzeichenfolge ändern, wie ChangeExtensionz. B. , haben keine Auswirkungen auf die Namen von Dateien im Dateisystem.

Einige Path Member überprüfen den Inhalt einer angegebenen Pfadzeichenfolge und lösen einen aus ArgumentException , wenn die Zeichenfolge Zeichen enthält, die in Pfadzeichenfolgen nicht gültig sind, wie in den von der GetInvalidPathChars -Methode zurückgegebenen Zeichen definiert. Auf Windows-basierten Desktopplattformen können ungültige Pfadzeichen beispielsweise Anführungszeichen ("), kleiner als (), größer als (<>), pipe (|), Backspace (\b), NULL (\0) und Unicode-Zeichen 16 bis 18 und 20 bis 25 enthalten. Dieses Validierungsverhalten variiert zwischen .NET-Versionen:

• In .NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: Alle Path Member, die einen Pfad als Argument annehmen, lösen ein ausArgumentException, wenn ungültige Pfadzeichen erkannt werden.

• In .NET Core 2.1 und höheren Versionen: GetFullPath ist das einzige Element, das ein ArgumentException auslöst, wenn die Zeichenfolge ungültige Pfadzeichen enthält.

Mit den Membern der Path -Klasse können Sie schnell und einfach allgemeine Vorgänge ausführen, z. B. bestimmen, ob eine Dateinamenerweiterung Teil eines Pfads ist, und zwei Zeichenfolgen zu einem Pfadnamen kombinieren.

Alle Member der Path -Klasse sind statisch und können daher aufgerufen werden, ohne eine instance eines Pfads zu haben.

In 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 einen UNC-Pfad (Universal Naming Convention) für einen Server- und Freigabenamen verweisen. Beispielsweise sind alle folgenden Pfade akzeptabel:

• "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 Vorgänge für Zeichenfolgen ausgeführt werden, kann nicht überprüft werden, ob die Ergebnisse in allen Szenarien gültig sind. Die -Methode analysiert beispielsweise eine Zeichenfolge, GetExtension die Sie an sie übergeben, 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.

Felder

Methoden

Gilt für:

Weitere Informationen

• Datei- und Stream-E/A
• How to: Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei
• How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei
• Formate von Dateipfaden unter Windows-Systemen