Path.GetDirectoryName Méthode

Définition

Espace de noms:

System.IO

Assemblys:

netstandard.dll, System.Runtime.dll

Surcharges

Nom	Description
GetDirectoryName(String)	Retourne les informations de répertoire pour le chemin d’accès spécifié.
GetDirectoryName(ReadOnlySpan<Char>)	Retourne les informations de répertoire pour le chemin d’accès spécifié représenté par une étendue de caractères.

GetDirectoryName(String)

Source:

Path.cs

Retourne les informations de répertoire pour le chemin d’accès spécifié.

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

public static string? GetDirectoryName(string? path);

static member GetDirectoryName : string -> string

Public Shared Function GetDirectoryName (path As String) As String

Paramètres

path

String

Chemin d’accès d’un fichier ou d’un répertoire.

Retours

String

Informations de répertoire pour path, ou null si path indique un répertoire racine ou est null. Retourne Empty si path elle ne contient pas d’informations d’annuaire.

Exceptions

ArgumentException

.NET Framework et les versions .NET Core antérieures à la version 2.1 : le paramètre path contient des caractères non valides, est vide ou contient uniquement des espaces blancs.

PathTooLongException

Le path paramètre est plus long que la longueur maximale définie par le système.

Exemples

L’exemple suivant illustre l’utilisation de la méthode GetDirectoryName sur une plateforme de bureau Windows.

string? filePath = @"C:\MyDir\MySubDir\myfile.ext";
string? directoryName;
int i = 0;

while (filePath != null)
{
    directoryName = Path.GetDirectoryName(filePath);
    Console.WriteLine($"GetDirectoryName(\"{filePath}\") returns {directoryName ?? "NULL"}");

    filePath = (i == 1)
        ? directoryName + @"\"  // this will preserve the previous path
        : directoryName;

    i++;
}
/*
This code produces the following output:

GetDirectoryName("C:\MyDir\MySubDir\myfile.ext") returns C:\MyDir\MySubDir
GetDirectoryName("C:\MyDir\MySubDir") returns C:\MyDir
GetDirectoryName("C:\MyDir\") returns C:\MyDir
GetDirectoryName("C:\MyDir") returns C:\
GetDirectoryName("C:\") returns NULL
*/

Dim filepath As String = "C:\MyDir\MySubDir\myfile.ext"
Dim directoryName As String
Dim i As Integer = 0

While filepath <> Nothing
    directoryName = Path.GetDirectoryName(filepath)
    Console.WriteLine("GetDirectoryName('{0}') returns '{1}'", _
        filepath, directoryName)
    filepath = directoryName
    If i = 1 Then
       filepath = directoryName + "\"  ' this will preserve the previous path
    End If
    i = i + 1
End While

'This code produces the following output:
'
' GetDirectoryName('C:\MyDir\MySubDir\myfile.ext') returns 'C:\MyDir\MySubDir'
' GetDirectoryName('C:\MyDir\MySubDir') returns 'C:\MyDir'
' GetDirectoryName('C:\MyDir\') returns 'C:\MyDir'
' GetDirectoryName('C:\MyDir') returns 'C:\'
' GetDirectoryName('C:\') returns ''

Remarques

Dans la plupart des cas, la chaîne retournée par cette méthode se compose de tous les caractères du chemin jusqu’à, mais pas d’inclusion, du ou des derniers caractères de séparateur de répertoires. Un caractère de séparateur de répertoire peut être soit DirectorySeparatorChar ou AltDirectorySeparatorChar. Si le chemin se compose d’un répertoire racine, tel que « c :\ », null est retourné.

Cette méthode ne prend pas en charge les chemins d’accès à l’aide de « file : ».

Étant donné que le chemin d’accès retourné n’inclut pas le ou les derniers caractères de séparateur de répertoires, le passage du chemin retourné à la GetDirectoryName méthode tronque un niveau de dossier par appel suivant sur le chemin de résultat. Par exemple, en passant le chemin d’accès «C:\Directory\SubDirectory\test.txt» dans GetDirectoryName retourne « C :\Directory\SubDirectory ». Passage de ce chemin d’accès, « C :\Directory\SubDirectory », dans GetDirectoryName retourne « C :\Directory ».

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 Fichier 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

GetDirectoryName(ReadOnlySpan<Char>)

Source:

Path.cs

Retourne les informations de répertoire pour le chemin d’accès spécifié représenté par une étendue de caractères.

public:
 static ReadOnlySpan<char> GetDirectoryName(ReadOnlySpan<char> path);

public static ReadOnlySpan<char> GetDirectoryName(ReadOnlySpan<char> path);

static member GetDirectoryName : ReadOnlySpan<char> -> ReadOnlySpan<char>

Public Shared Function GetDirectoryName (path As ReadOnlySpan(Of Char)) As ReadOnlySpan(Of Char)

Paramètres

path

ReadOnlySpan<Char>

Chemin d’accès à partir duquel récupérer les informations du répertoire.

Retours

ReadOnlySpan<Char>

Informations de répertoire pour path, ou une étendue vide si c’est le cas pathnull, une étendue vide ou une racine (par exemple\, C :ou \\server\share).

Remarques

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

Voir aussi

• formats de chemin d’accès Fichier sur les systèmes Windows