Path.GetPathRoot Metod

Definition

Namnområde:
System.IO
Sammansättning:
netstandard.dll
Sammansättningar:
mscorlib.dll, System.Runtime.Extensions.dll
Sammansättning:
mscorlib.dll
Sammansättning:
System.Runtime.Extensions.dll

Överlagringar

Name Description
GetPathRoot(ReadOnlySpan<Char>)

Hämtar rotkataloginformationen från sökvägen i det angivna teckenintervallet.
GetPathRoot(String)

Hämtar rotkataloginformationen från sökvägen som finns i den angivna strängen.

GetPathRoot(ReadOnlySpan<Char>)

Hämtar rotkataloginformationen från sökvägen i det angivna teckenintervallet.

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)

Parametrar

path
ReadOnlySpan<Char>

Ett skrivskyddat intervall med tecken som innehåller sökvägen för att hämta rotkataloginformation.

Returer

ReadOnlySpan<Char>

Ett skrivskyddat intervall med tecken som innehåller rotkatalogen pathför .

Kommentarer

Den här metoden verifierar inte att sökvägen eller filen finns.

Till skillnad från strängöverlagringen normaliserar inte den här metoden katalogavgränsare.

A ReadOnlySpan<System.Char> är "i praktiken tom" om:

  • I Windows returnerar anropande ReadOnlySpan<T>.IsEmpty på det här intervallet av tecken true, eller så är alla dess tecken blanksteg (' ').
  • I Unix returnerar trueanrop ReadOnlySpan<T>.IsEmpty på det här intervallet med tecken .

Möjliga mönster för det skrivskyddade teckenintervallet som returneras av den här metoden är följande:

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

  • ReadOnlySpan<T>.Empty (path angav en relativ sökväg på den aktuella enheten eller volymen).

  • "/" (Unix: path angav en absolut sökväg på den aktuella enheten).

  • "X:" (Windows: path angav en relativ sökväg på en enhet, där X representerar en enhet eller volymbeteckning).

  • "X:\" (Windows: path angav en absolut sökväg på en viss enhet).

  • "\\ComputerName\SharedFolder" (Windows: en UNC-sökväg).

  • "\\?\C:" (Windows: en DOS-enhetssökväg som stöds i .NET versioner och i .NET Framework 4.6.2 och senare versioner).

Mer information om filsökvägar på Windows finns i File path formats on Windows systems. En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.

Se även

Gäller för

GetPathRoot(String)

Hämtar rotkataloginformationen från sökvägen som finns i den angivna strängen.

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

Parametrar

path
String

En sträng som innehåller sökvägen för att hämta rotkataloginformation.

Returer

String

Rotkatalogen path för om den är rotad.

-eller-

Empty om path inte innehåller rotkataloginformation.

-eller-

null om path är null eller är i praktiken tom.

Undantag

ArgumentException

.NET Framework- och .NET Core-versioner som är äldre än 2.1: path innehåller ett eller flera av de ogiltiga tecken som definierats i GetInvalidPathChars().

-eller-

endast .NET Framework: Empty skickades till path.

Exempel

I följande exempel visas hur metoden används GetPathRoot .

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:\'

Kommentarer

Den här metoden verifierar inte att sökvägen eller filen finns.

Den här metoden normaliserar katalogavgränsare.

En sträng är "i praktiken tom" om:

  • I Windows returnerar anropande IsEmpty på den här strängen true, eller så är alla dess tecken blanksteg (" ).
  • I Unix returnerar trueanrop på IsNullOrEmpty den här strängen .

Möjliga mönster för strängen som returneras av den här metoden är följande:

  • null (path var null eller en tom sträng).

  • En tom sträng (path angav en relativ sökväg på den aktuella enheten eller volymen).

  • "/" (Unix: path angav en absolut sökväg på den aktuella enheten).

  • "X:" (Windows: path angav en relativ sökväg på en enhet, där X representerar en enhet eller volymbeteckning).

  • "X:\" (Windows: path angav en absolut sökväg på en viss enhet).

  • "\\ComputerName\SharedFolder" (Windows: en UNC-sökväg).

  • "\\?\C:" (Windows: en DOS-enhetssökväg som stöds i .NET versioner och i .NET Framework 4.6.2 och senare versioner).

Mer information om filsökvägar på Windows finns i File path formats on Windows systems. En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.

Se även

Gäller för