Path.GetFileName Méthode

Définition

Espace de noms:

System.IO

Assemblys:

netstandard.dll, System.Runtime.dll

Surcharges

Nom	Description
GetFileName(ReadOnlySpan<Char>)	Renvoie le nom de fichier et l’extension d’un chemin d’accès de fichier représenté par une étendue de caractères en lecture seule.
GetFileName(String)	Retourne le nom de fichier et l’extension de la chaîne de chemin d’accès spécifiée.

GetFileName(ReadOnlySpan<Char>)

Source:

Path.cs

Renvoie le nom de fichier et l’extension d’un chemin d’accès de fichier représenté par une étendue de caractères en lecture seule.

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

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

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

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

Paramètres

path

ReadOnlySpan<Char>

Étendue en lecture seule qui contient le chemin d’accès à partir duquel obtenir le nom et l’extension de fichier.

Retours

ReadOnlySpan<Char>

Caractères qui suivent le dernier caractère de séparateur de répertoire ou la racine de path, le cas plus tard.

Remarques

L’étendue en lecture seule retournée contient les caractères de path ce dernier caractère de séparateur de répertoire ou la fin de la racine de path (comme retourné par GetPathRoot), selon la date qui vient plus tard. Si path elle se termine par un caractère de séparateur de répertoire ou se compose uniquement d’une racine, la méthode retourne ReadOnlySpan<T>.Empty. Si path elle ne contient ni un caractère de séparation de répertoire ni une racine, la méthode retourne path.

Sur Windows, la racine peut être, par exemple, un lecteur ou un partage UNC. Pour les autres formats racines, tels que les chemins d’accès d’appareil DOS, consultez les formats de chemin d’accès de fichier sur les systèmes Windows. Dans C:file.txt, la racine est C:, donc le nom de fichier est file.txt. Une racine UNC telle que \\server\share contient des séparateurs de répertoires, mais elles font partie de la racine et ne marquent pas le début du nom de fichier. Par conséquent, le nom de fichier est \\server\share\file.txtfile.txt, et le nom de fichier dans \\server\share est vide, car le chemin d’accès entier est la racine.

Voir aussi

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

GetFileName(String)

Source:

Path.cs

Retourne le nom de fichier et l’extension de la chaîne de chemin d’accès spécifiée.

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

public static string? GetFileName(string? path);

static member GetFileName : string -> string

Public Shared Function GetFileName (path As String) As String

Paramètres

path

String

Chaîne de chemin d’accès à partir de laquelle obtenir le nom et l’extension de fichier.

Retours

String

Caractères qui suivent le dernier caractère de séparateur de répertoire ou la racine de path, le cas échéant, ou null si c’est nullle caspath.

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().

Exemples

L’exemple suivant illustre le comportement de la méthode GetFileName sur une plateforme de bureau basée sur Windows.

string fileName = @"C:\mydir\myfile.ext";
string path = @"C:\mydir\";
string result;

result = Path.GetFileName(fileName);
Console.WriteLine("GetFileName('{0}') returns '{1}'",
    fileName, result);

result = Path.GetFileName(path);
Console.WriteLine("GetFileName('{0}') returns '{1}'",
    path, result);

// This code produces output similar to the following:
//
// GetFileName('C:\mydir\myfile.ext') returns 'myfile.ext'
// GetFileName('C:\mydir\') returns ''

Dim fileName As String = "C:\mydir\myfile.ext"
Dim pathname As String = "C:\mydir\"
Dim result As String

result = Path.GetFileName(fileName)
Console.WriteLine("GetFileName('{0}') returns '{1}'", fileName, result)

result = Path.GetFileName(pathname)
Console.WriteLine("GetFileName('{0}') returns '{1}'", pathname, result)

' This code produces output similar to the following:
'
' GetFileName('C:\mydir\myfile.ext') returns 'myfile.ext'
' GetFileName('C:\mydir\') returns ''

Remarques

La valeur retournée est null si le chemin d’accès au fichier est null.

La chaîne retournée contient les caractères de path ce qui suit le dernier ou AltDirectorySeparatorChar le dernier DirectorySeparatorChar caractère ou la fin de la racine de path (tel qu’il est retourné parGetPathRoot), le cas échéant. Si path elle se termine par un caractère de séparateur de répertoire ou se compose uniquement d’une racine, la méthode retourne String.Empty. Si path elle ne contient ni un caractère de séparation de répertoire ni une racine, la méthode retourne path.

Sur Windows, la racine peut être, par exemple, un lecteur ou un partage UNC. Pour les autres formats racines, tels que les chemins d’accès d’appareil DOS, consultez les formats de chemin d’accès de fichier sur les systèmes Windows. Dans C:file.txt, la racine est C:, donc le nom de fichier est file.txt. Une racine UNC telle que \\server\share contient des séparateurs de répertoires, mais elles font partie de la racine et ne marquent pas le début du nom de fichier. Par conséquent, le nom de fichier est \\server\share\file.txtfile.txt, et le nom de fichier dans \\server\share est vide, car le chemin d’accès entier est la racine.

Étant donné que \ est un nom de fichier légal sur Unix, GetFileName s’exécutant sous les plateformes Unix ne peut pas renvoyer correctement le nom de fichier à partir d’un chemin d’accès Windows basé sur C :\mydir\myfile.ext, mais GetFileName en cours d’exécution sous des plateformes basées sur Windows peut retourner correctement le nom de fichier à partir d’un chemin d’accès Unix comme /tmp/myfile.ext, Ainsi, le comportement de la méthode GetFileName n’est pas strictement identique sur les plateformes basées sur Unix et 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 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