Path.GetPathRoot Méthode

Source:

Path.Unix.cs

Source:

Path.Unix.cs

Source:

Path.Unix.cs

public:
 static System::String ^ GetPathRoot(System::String ^ path);

public static string GetPathRoot (string path);

public static string? GetPathRoot (string? path);

static member GetPathRoot : string -> string

Public Shared Function GetPathRoot (path As String) As String

Paramètres

Retours

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

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

Source:

Path.Unix.cs

Source:

Path.Unix.cs

Source:

Path.Unix.cs

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

Retours

É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