Path.GetPathRoot Metódus

Definíció

Névtér:
System.IO
Szerelvény:
netstandard.dll
Szerelvények:
mscorlib.dll, System.Runtime.Extensions.dll
Szerelvény:
mscorlib.dll
Szerelvény:
System.Runtime.Extensions.dll

Túlterhelések

Name Description
GetPathRoot(ReadOnlySpan<Char>)

Lekéri a gyökérkönyvtár adatait a megadott karaktertartományban található elérési útról.
GetPathRoot(String)

Lekéri a gyökérkönyvtár adatait a megadott sztringben található elérési útról.

GetPathRoot(ReadOnlySpan<Char>)

Lekéri a gyökérkönyvtár adatait a megadott karaktertartományban található elérési útról.

public:
 static ReadOnlySpan<char> GetPathRoot(ReadOnlySpan<char> path);
public static ReadOnlySpan<char> GetPathRoot(ReadOnlySpan<char> path);
static member GetPathRoot : ReadOnlySpan<char> -> ReadOnlySpan<char>
Public Shared Function GetPathRoot (path As ReadOnlySpan(Of Char)) As ReadOnlySpan(Of Char)

Paraméterek

path
ReadOnlySpan<Char>

A gyökérkönyvtár-információk lekérésének elérési útját tartalmazó írásvédett karakterek száma.

Válaszok

ReadOnlySpan<Char>

A karakterek írásvédett tartománya, amely a következő gyökérkönyvtárát pathtartalmazza: .

Megjegyzések

Ez a metódus nem ellenőrzi, hogy az elérési út vagy fájl létezik-e.

A sztring túlterhelésétől eltérően ez a módszer nem normalizálja a címtárelválasztókat.

Az A ReadOnlySpan<System.Char> "gyakorlatilag üres", ha:

A metódus által visszaadott írásvédett karaktertartomány lehetséges mintái a következők:

  • ReadOnlySpan<T>.Empty (path volt ReadOnlySpan<T>.Empty.

  • ReadOnlySpan<T>.Empty (path megadott egy relatív elérési utat az aktuális meghajtón vagy köteten).

  • "/" (Unix: path abszolút elérési utat adott meg az aktuális meghajtón).

  • "X:" (Windows: path relatív elérési utat adott meg egy meghajtón, ahol X meghajtót vagy kötetbetűjelet jelöl).

  • "X:\" (Windows: path megadott egy abszolút elérési utat egy adott meghajtón).

  • "\\ComputerName\SharedFolder" (Windows: UNC elérési út).

  • "\\\?\C:" (Windows: egy DOS-eszközútvonal, amely .NET verziókban és .NET Framework 4.6.2-s és újabb verzióiban támogatott).

A Windows fájlútvonaláról további információt a File path formátumok Windows rendszereken című témakörben talál. A gyakori I/O-feladatok listáját a Gyakori I/O-feladatok című témakörben találja.

Lásd még

A következőre érvényes:

GetPathRoot(String)

Lekéri a gyökérkönyvtár adatait a megadott sztringben található elérési útról.

public:
 static System::String ^ GetPathRoot(System::String ^ path);
public static string GetPathRoot(string path);
static member GetPathRoot : string -> string
Public Shared Function GetPathRoot (path As String) As String

Paraméterek

path
String

Egy sztring, amely azt az elérési utat tartalmazza, amelyből a gyökérkönyvtár információi lekérhetőek.

Válaszok

String

Annak gyökérkönyvtára path , ha gyökerezik.

-vagy-

Empty ha path nem tartalmaz gyökérkönyvtár-információt.

-vagy-

null ha path üres null , vagy gyakorlatilag üres.

Kivételek

ArgumentException

.NET Framework és .NET Core 2.1-nél régebbi verziói: pathGetInvalidPathChars() egy vagy több érvénytelen karaktert tartalmaz.

-vagy-

csak .NET keretrendszer: Empty lett átadva path.

Példák

Az alábbi példa a módszer használatát GetPathRoot mutatja be.

string path = @"\mydir\";
string fileName = "myfile.ext";
string fullPath = @"C:\mydir\myfile.ext";
string pathRoot;

pathRoot = Path.GetPathRoot(path);
Console.WriteLine("GetPathRoot('{0}') returns '{1}'",
    path, pathRoot);

pathRoot = Path.GetPathRoot(fileName);
Console.WriteLine("GetPathRoot('{0}') returns '{1}'",
    fileName, pathRoot);

pathRoot = Path.GetPathRoot(fullPath);
Console.WriteLine("GetPathRoot('{0}') returns '{1}'",
    fullPath, pathRoot);

// This code produces output similar to the following:
//
// GetPathRoot('\mydir\') returns '\'
// GetPathRoot('myfile.ext') returns ''
// GetPathRoot('C:\mydir\myfile.ext') returns 'C:\'

Dim pathname As String = "\mydir\"
Dim fileName As String = "myfile.ext"
Dim fullPath As String = "C:\mydir\myfile.ext"
Dim pathnameRoot As String

pathnameRoot = Path.GetPathRoot(pathname)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", pathname, pathnameRoot)

pathnameRoot = Path.GetPathRoot(fileName)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", fileName, pathnameRoot)

pathnameRoot = Path.GetPathRoot(fullPath)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", fullPath, pathnameRoot)

' This code produces output similar to the following:
'
' GetPathRoot('\mydir\') returns '\'
' GetPathRoot('myfile.ext') returns ''
' GetPathRoot('C:\mydir\myfile.ext') returns 'C:\'

Megjegyzések

Ez a metódus nem ellenőrzi, hogy az elérési út vagy fájl létezik-e.

Ez a módszer normalizálja a címtárelválasztókat.

A sztring "gyakorlatilag üres", ha:

  • A Windows a IsEmpty meghívása ezen a sztringen true, vagy minden karaktere szóköz (' ').
  • A Unixban a sztring meghívása IsNullOrEmptytruead vissza.

A metódus által visszaadott sztring lehetséges mintái a következők:

  • null (path null vagy üres sztring).

  • Üres sztring (path relatív elérési utat adott meg az aktuális meghajtón vagy köteten).

  • "/" (Unix: path abszolút elérési utat adott meg az aktuális meghajtón).

  • "X:" (Windows: path relatív elérési utat adott meg egy meghajtón, ahol X meghajtót vagy kötetbetűjelet jelöl).

  • "X:\" (Windows: path megadott egy abszolút elérési utat egy adott meghajtón).

  • "\\ComputerName\SharedFolder" (Windows: UNC elérési út).

  • "\\\?\C:" (Windows: egy DOS-eszközútvonal, amely .NET verziókban és .NET Framework 4.6.2-s és újabb verzióiban támogatott).

A Windows fájlútvonaláról további információt a File path formátumok Windows rendszereken című témakörben talál. A gyakori I/O-feladatok listáját a Gyakori I/O-feladatok című témakörben találja.

Lásd még

A következőre érvényes: