Path.GetFileName Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

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

GetFileName(ReadOnlySpan<Char>)

Source:

Path.cs

Renvoie le nom et l'extension d'un chemin 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 contenant le chemin d'accès à partir duquel vous pouvez obtenir le nom et l'extension du fichier.

Retours

ReadOnlySpan<Char>

Caractères situés après le dernier caractère de séparation du répertoire dans path.

Remarques

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

Voir aussi

• Formats de chemin de fichier sur les systèmes Windows

GetFileName(String)

Source:

Path.cs

Retourne le nom et l’extension de fichier 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 situés après le dernier caractère de séparation du répertoire dans path. Si le dernier caractère de path est un caractère de séparation de répertoire ou de volume, cette méthode retourne Empty. Si path est null, cette méthode retourne null.

Exceptions

ArgumentException

.NET Framework et .NET Core versions antérieures à 2.1 : path contient un ou plusieurs caractères non valides définis dans GetInvalidPathChars().

Exemples

L’exemple suivant illustre le comportement de la GetFileName méthode sur une plateforme de bureau 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 ''

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