Path.GetPathRoot Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

GetPathRoot(String)	Obtient les informations du répertoire racine à partir du chemin d’accès contenu dans la chaîne spécifiée.
GetPathRoot(ReadOnlySpan<Char>)	Obtient les informations du répertoire racine à partir du chemin d’accès contenu dans l’étendue de caractères spécifiée.

GetPathRoot(String)

Source:

Path.Unix.cs

Obtient les informations du répertoire racine à partir du chemin d’accès contenu dans la chaîne spécifiée.

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ètres

path

String

Une chaîne contenant le chemin d'accès à partir duquel obtenir les informations relatives au répertoire racine.

Retours

String

Répertoire racine de path s’il est rooté.

- ou -

Empty si path ne contient pas d'informations relatives au répertoire racine.

- ou -

null si path est null ou est effectivement vide.

Exceptions

ArgumentException

.NET Framework et .NET Core versions antérieures à 2.1 : path contient un ou plusieurs des caractères non valides définis dans GetInvalidPathChars().

- ou -

.NET Framework uniquement : Empty a été passé à path.

Exemples

L’exemple suivant illustre l’utilisation de la GetPathRoot méthode .

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

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

Remarques

Cette méthode ne vérifie pas que le chemin d’accès ou le fichier existe.

Cette méthode normalisera les séparateurs de répertoires.

Une chaîne est « effectivement vide » si :

• Dans Windows, l’appel IsEmpty sur cette chaîne retourne true, ou tous ses caractères sont des espaces (' ').
• Dans Unix, l’appel IsNullOrEmpty sur cette chaîne retourne true.

Les modèles possibles pour la chaîne retournée par cette méthode sont les suivants :

• null (path était null ou une chaîne vide).

• Chaîne vide (path spécifié un chemin d’accès relatif sur le lecteur ou le volume actuel).

• « / » (Unix : path spécifié un chemin absolu sur le lecteur actuel).

• « X : » (Windows : path spécifie un chemin relatif sur un lecteur, où X représente un lecteur ou une lettre de volume).

• « X :\ » (Windows : path a spécifié un chemin absolu sur un lecteur donné).

• « \\ComputerName\SharedFolder » (Windows : chemin UNC).

• « \\ ?\C : » (Windows : chemin d’accès d’appareil DOS, pris en charge dans .NET Core 1.1 et versions ultérieures, et dans .NET Framework 4.6.2 et versions ultérieures).

Pour plus d’informations sur les chemins d’accès aux fichiers sur Windows, consultez Formats de chemin d’accès de fichier sur les systèmes Windows. Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

• Formats de chemin de fichier sur les systèmes Windows
• Fichier et flux de données E/S
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier

GetPathRoot(ReadOnlySpan<Char>)

Source:

Path.Unix.cs

Obtient les informations du répertoire racine à partir du chemin d’accès contenu dans l’étendue de caractères spécifiée.

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ètres

path

ReadOnlySpan<Char>

Étendue en lecture seule de caractères contenant le chemin d’accès à partir duquel obtenir les informations relatives au répertoire racine.

Retours

ReadOnlySpan<Char>

Étendue de caractères en lecture seule contenant contient le répertoire racine de path.

Remarques

Cette méthode ne vérifie pas que le chemin d’accès ou le fichier existe.

Contrairement à la surcharge de chaîne, cette méthode ne normalise pas les séparateurs de répertoires.

Un ReadOnlySpan<System.Char> est « effectivement vide » si :

• Dans Windows, l’appel ReadOnlySpan<T>.IsEmpty sur cette étendue de caractères retourne true, ou tous ses caractères sont des espaces (' ').
• Dans Unix, l’appel ReadOnlySpan<T>.IsEmpty sur cette étendue de caractères retourne true.

Les modèles possibles pour l’étendue de caractères en lecture seule retournée par cette méthode sont les suivants :

• ReadOnlySpan<T>.Empty (path était ReadOnlySpan<T>.Empty.

• ReadOnlySpan<T>.Empty (path a spécifié un chemin d’accès relatif sur le lecteur ou le volume actuel).

• « / » (Unix : path spécifié un chemin absolu sur le lecteur actuel).

• « X : » (Windows : path spécifie un chemin relatif sur un lecteur, où X représente un lecteur ou une lettre de volume).

• « X :\ » (Windows : path a spécifié un chemin absolu sur un lecteur donné).

• « \\ComputerName\SharedFolder » (Windows : chemin UNC).

• « \\ ?\C : » (Windows : chemin d’accès d’appareil DOS, pris en charge dans .NET Core 1.1 et versions ultérieures, et dans .NET Framework 4.6.2 et versions ultérieures).

Pour plus d’informations sur les chemins d’accès aux fichiers sur Windows, consultez Formats de chemin d’accès de fichier sur les systèmes Windows. Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

• Formats de chemin de fichier sur les systèmes Windows