Path.GetFileName-Methode

Artikel
08/20/2007

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
ArgumentException	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.	Gewusst wie: Schreiben von Text in eine Datei
Schreiben in eine Textdatei.	Gewusst wie: Schreiben von Text in eine Datei
Lesen aus einer Textdatei.	Gewusst wie: Lesen aus einer Textdatei
Abrufen des voll qualifizierten Pfades einer Datei.	GetFullPath
Nur den Dateinamen aus einem Pfad abrufen.	GetFileNameWithoutExtension
Nur den Verzeichnisnamen aus einem Pfad abrufen.	GetDirectoryName
Ändern der Erweiterung einer Datei.	ChangeExtension

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

Share via