Path.GetFileName-Methode
Gibt den Dateinamen und die Erweiterung der angegebenen Pfadzeichenfolge zurück.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Shared Function GetFileName ( _
path As String _
) As String
'Usage
Dim path As String
Dim returnValue As String
returnValue = Path.GetFileName(path)
public static string GetFileName (
string path
)
public:
static String^ GetFileName (
String^ path
)
public static String GetFileName (
String path
)
public static function GetFileName (
path : String
) : String
Parameter
- path
Die Pfadzeichenfolge, aus der der Dateiname und die Erweiterung abgerufen werden sollen.
Rückgabewert
Ein String, bestehend aus den Zeichen nach dem letzten Verzeichniszeichen in path. Wenn das letzte Zeichen von path ein Verzeichnis- bzw. Datenträgertrennzeichen ist, gibt diese Methode Empty zurück. Wenn path gleich NULL (Nothing in Visual Basic) ist, gibt diese Methode NULL (Nothing in Visual Basic) zurück.
Ausnahmen
Ausnahmetyp | Bedingung |
---|---|
path enthält mindestens eins der in InvalidPathChars definierten ungültigen Zeichen oder ein Platzhalterzeichen. |
Hinweise
Der zurückgegebene Wert ist NULL (Nothing in Visual Basic), wenn der Dateipfad NULL (Nothing in Visual Basic) ist.
Die Trennzeichen, die den Anfang des Dateinamens bestimmen, sind DirectorySeparatorChar und AltDirectorySeparatorChar.
Ein Beispiel für die Verwendung dieser Methode finden Sie im Beispielabschnitt weiter unten. In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.
Aufgabe |
Beispiel in diesem Thema |
---|---|
Erstellen einer Textdatei. |
|
Schreiben in eine Textdatei. |
|
Lesen aus einer Textdatei. |
|
Abrufen des voll qualifizierten Pfades einer Datei. |
|
Nur den Dateinamen aus einem Pfad abrufen. |
|
Nur den Verzeichnisnamen aus einem Pfad abrufen. |
|
Ändern der Erweiterung einer Datei. |
Beispiel
Im folgenden Codebeispiel wird das Verhalten der GetFileName-Methode auf einer Desktopplattform auf Grundlage von Windows veranschaulicht.
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 ''
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 );
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);
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
Path-Klasse
Path-Member
System.IO-Namespace
Weitere Ressourcen
Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei