GetFileName, méthode

Path.GetFileName, méthode

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

Espace de noms : System.IO
Assembly : mscorlib (dans mscorlib.dll)

public static string GetFileName (
	string path
)
public static String GetFileName (
	String path
)
public static function GetFileName (
	path : String
) : String

Paramètres

path

Chaîne de chemin d'accès à partir de laquelle le nom et l'extension de fichier sont obtenus.

Valeur de retour

String comprenant les caractères situés après le dernier caractère 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 référence Null (Nothing en Visual Basic), cette méthode retourne référence Null (Nothing en Visual Basic).

Type d'exceptionCondition

ArgumentException

path contient un ou plusieurs des caractères non valides définis dans InvalidPathChars, ou contient un caractère générique.

La valeur retournée est référence Null (Nothing en Visual Basic) si le chemin d'accès du fichier est référence Null (Nothing en Visual Basic).

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

Pour obtenir un exemple d'utilisation de cette méthode, consultez la section Exemple ci-dessous. Le tableau suivant répertorie des exemples d'autres tâches d'E/S courantes ou apparentées.

Pour effectuer cette opération...

Consultez l'exemple qui se trouve dans cette rubrique...

Créer un fichier texte.

Comment : écrire du texte dans un fichier

Écrire dans un fichier texte.

Comment : écrire du texte dans un fichier

Lire à partir d'un fichier texte.

Comment : lire du texte dans un fichier

Récupérer le chemin d'accès qualifié complet d'un fichier.

GetFullPath

Récupérer uniquement le nom de fichier d'un chemin d'accès.

GetFileNameWithoutExtension

Récupérer uniquement le nom de répertoire d'un chemin d'accès.

GetDirectoryName

Modifier l'extension d'un fichier.

ChangeExtension

L'exemple de code suivant illustre le comportement de la méthode GetFileName sur une plate-forme 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);

var fileName : String = "C:\\mydir\\myfile.ext";
var path : String = "C:\\mydir\\";
var result : String;

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

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2016 Microsoft