Path.GetFileName Méthode

Définition

Espace de noms:
System.IO
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll
Assemblys:
mscorlib.dll, System.Runtime.Extensions.dll
Assembly:
mscorlib.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
Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
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 après le dernier caractère de séparateur de répertoire dans path.

Remarques

L’étendue en lecture seule retournée contient les caractères du chemin qui suivent le dernier séparateur dans path. Si le dernier caractère est path un caractère de séparation de volume ou de répertoire, la méthode retourne ReadOnlySpan<T>.Empty. Si path elle ne contient aucun caractère de séparateur, la méthode retourne path.

Voir aussi

S’applique à

GetFileName(String)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
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);
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 après le dernier caractère de séparateur de répertoire dans path. Si le dernier caractère est un caractère de séparateur de répertoire ou de path volume, cette méthode retourne Empty. Si path c’est nullle cas, cette méthode retourne null.

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.

Les caractères de séparation utilisés pour déterminer le début du nom de fichier sont DirectorySeparatorChar et AltDirectorySeparatorChar.

É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

S’applique à