Path.GetPathRoot Méthode

Définition

Espace de noms:

System.IO

Assemblys:

netstandard.dll, System.Runtime.dll

Surcharges

Nom	Description
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 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

Chaîne contenant le chemin d’accès à partir duquel obtenir des informations de répertoire racine.

Retours

String

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

- ou -

Empty s’il path ne contient pas d’informations de répertoire racine.

- ou -

null s’il path est null ou est effectivement vide.

Exceptions

ArgumentException

Versions .NET Framework et .NET Core 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 une 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:\'

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 normalise les séparateurs de répertoires.

Une chaîne est « effectivement vide » si :

• Dans Windows, l’appel IsEmpty de 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 a été null ou une chaîne vide).

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

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

• « X : » (Windows : path a spécifié 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 les versions .NET 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 les 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 d’E/S courantes.

Voir aussi

• Formats de chemin d’accès aux fichiers sur les systèmes Windows
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier

GetPathRoot(ReadOnlySpan<Char>)

Source:

Path.Unix.cs

Obtient les informations du répertoire racine 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 des informations de répertoire racine.

Retours

ReadOnlySpan<Char>

Étendue en lecture seule de caractères contenant 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.

A 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 spécifié un chemin relatif sur le lecteur ou le volume actuel).

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

• « X : » (Windows : path a spécifié 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 les versions .NET 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 les 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 d’E/S courantes.

Voir aussi

• Formats de chemin d’accès aux fichiers sur les systèmes Windows