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 Hauptmmer 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 bereitstellt. Ein Pfad verweist nicht unbedingt auf einen Speicherort auf dem Datenträger. Beispielsweise kann ein Pfad zu einem Speicherort im Arbeitsspeicher oder auf einem Gerät zugeordnet werden. Das genaue Format eines Pfads wird von der aktuellen Plattform bestimmt. Beispielsweise kann ein Pfad auf einigen Systemen mit einem Laufwerk- 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 auf kleinerem Flashspeicher und älteren Versionen von ISO 9660 verwendet werden, die auf optischen Medien verwendet werden), und 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 einen Speicherort vollständig 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 beim Suchen einer Datei, die mit einem relativen Pfad angegeben ist, als Ausgangspunkt verwendet. Rufen Sie Directory.GetCurrentDirectoryauf, um das aktuelle Verzeichnis zu ermitteln.

.NET Core 1.1 und höhere Versionen und .NET Framework 4.6.2 und höhere Versionen 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 das Vorhandensein der datei, die durch eine Pfadzeichenfolge angegeben ist. Path Klassenmember, die eine Pfadzeichenfolge ändern, z. B. ChangeExtension, haben keine Auswirkungen auf Die Namen von Dateien im Dateisystem.

Einige Path Member überprüfen den Inhalt einer angegebenen Pfadzeichenfolge und lösen eine ArgumentException aus, wenn die Zeichenfolge Zeichen enthält, die in Pfadzeichenfolgen ungültig sind, wie in den von der GetInvalidPathChars-Methode zurückgegebenen Zeichen definiert. Beispielsweise können auf Windows-basierten Desktopplattformen ungültige Pfadzeichen Anführungszeichen ("), kleiner als (<), größer als (>), Pipe (|), Rücktaste (\b), Null (\0) und Unicode-Zeichen 16 bis 18 und 20 bis 25 enthalten. Dieses Überprüfungsverhalten 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 verwenden, lösen eine ArgumentException aus, wenn sie ungültige Pfadzeichen erkennen.

• In .NET Core 2.1 und höheren Versionen: GetFullPath ist das einzige Element, das eine 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 in einem Pfadnamen kombinieren.

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

In Mitgliedern, 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 zulässigen Pfade:

• "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, ist es unmöglich zu überprüfen, ob die Ergebnisse in allen Szenarien gültig sind. Die GetExtension-Methode analysiert beispielsweise eine Zeichenfolge, 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: Read Text from a File
• How to: Write Text to a File
• Gewusst wie: Lesen und Schreiben in eine neu erstellte Datendatei
• Dateiformate auf Windows-Systemen