Path Třída

Definice

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

Dědičnost

Object

Path

Atributy

ComVisibleAttribute

Příklady

Následující příklad ukazuje některé hlavní členy Path třídy.

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

Poznámky

Cesta je řetězec, který poskytuje umístění souboru nebo adresáře. Cesta nemusí nutně odkazovat na umístění na disku; Například cesta se může mapovat na umístění v paměti nebo na zařízení. Přesný formát cesty je určen aktuální platformou. Například v některých systémech může cesta začínat písmenem jednotky nebo svazku, zatímco tento prvek není v jiných systémech. V některých systémech můžou cesty k souborům obsahovat přípony, které označují typ informací uložených v souboru. Formát přípony názvu souboru je závislý na platformě; Některé systémy například omezují rozšíření na tři znaky (například FAT16 běžně používané v menších flash úložištích a starších verzích ISO 9660 používaných na optickém médiu) a jiné ne. Aktuální platforma také určuje sadu znaků použitých k oddělení prvků cesty a sadu znaků, které nelze použít při zadávání cest. Z těchto rozdílů jsou pole třídy Path i přesné chování některých členů třídy Path závislé na platformě.

Cesta může obsahovat absolutní nebo relativní informace o poloze. Absolutní cesty plně určují umístění: soubor nebo adresář lze jednoznačně identifikovat bez ohledu na aktuální umístění. Relativní cesty určují částečné umístění: aktuální umístění se použije jako výchozí bod při vyhledání souboru zadaného s relativní cestou. Chcete-li určit aktuální adresář, zavolejte Directory.GetCurrentDirectory.

.NET Core 1.1 a novější verze a .NET Framework 4.6.2 a novější verze také podporují přístup k objektům systému souborů, které jsou názvy zařízení, například \\?\C:\.

Další informace o formátech cest k souborům ve Windows naleznete v tématu Formáty cesty k souboru v systémech Windows.

Většina členů Path třídy nepracuje se systémem souborů a neověřuje existenci souboru určeného řetězcem cesty. Path členy třídy, které upravují řetězec cesty, například ChangeExtension, nemají žádný vliv na názvy souborů v systému souborů.

Někteří Path členové ověřují obsah zadaného řetězce cesty a vyvolá ArgumentException, pokud řetězec obsahuje znaky, které nejsou platné v řetězcích cesty, jak je definováno v znacích vrácených z metody GetInvalidPathChars. Například na desktopových platformách s Windows můžou neplatné znaky cesty obsahovat uvozovky ("), menší než (<), větší než (>), pipe (|), backspace (\b), null (\0) a znaky Unicode 16 až 18 až 20 až 25. Toto chování ověřování se liší mezi verzemi .NET:

• Ve verzích .NET Framework a .NET Core starších než 2.1: Všichni Path členové, kteří používají cestu jako argument, vyvolá ArgumentException, pokud zjistí neplatné znaky cesty.

• V .NET Core 2.1 a novějších verzích: GetFullPath je jediným členem, který vyvolá ArgumentException, pokud řetězec obsahuje neplatné znaky cesty.

Členové třídy Path umožňují rychle a snadno provádět běžné operace, jako je například určení, zda je přípona názvu souboru součástí cesty, a kombinování dvou řetězců do jednoho názvu cesty.

Všichni členové třídy Path jsou statické, a proto je lze volat bez výskytu cesty.

Ve členech, kteří přijímají cestu, může cesta odkazovat na soubor nebo pouze adresář. Zadaná cesta může také odkazovat na relativní cestu nebo cestu UNC (Universal Naming Convention) pro název serveru a sdílené složky. Například všechny následující cesty jsou přijatelné:

• "c:\\MyDir\\MyFile.txt" v jazyce C# nebo "c:\MyDir\MyFile.txt" v jazyce Visual Basic.

• "c:\\MyDir" v jazyce C# nebo "c:\MyDir" v jazyce Visual Basic.

• "MyDir\\MySubdir" v jazyce C# nebo "MyDir\MySubDir" v jazyce Visual Basic.

• "\\\\MyServer\\MyShare" v jazyce C# nebo "\\MyServer\MyShare" v jazyce Visual Basic.

Protože všechny tyto operace se provádějí s řetězci, není možné ověřit, zda jsou výsledky platné ve všech scénářích. Například metoda GetExtension parsuje řetězec, který jí předáte, a vrátí příponu z daného řetězce. To ale neznamená, že na disku existuje soubor s příponou.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.

Pole

Metody

Platí pro

Viz také

• soubor a streamování vstupně-výstupních
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru
• Postupy: Čtení a zápis do nově vytvořeného datového souboru
• formáty cest k souborům v systémech Windows