Freigeben über


Path.GetFileName Methode

Definition

Überlädt

GetFileName(ReadOnlySpan<Char>)

Gibt den Dateinamen und die Erweiterung eines Dateipfads zurück, der durch eine schreibgeschützte Zeichenspanne dargestellt wird.

GetFileName(String)

Gibt den Dateinamen und die Erweiterung der angegebenen Pfadzeichenfolge zurück.

GetFileName(ReadOnlySpan<Char>)

Quelle:
Path.cs
Quelle:
Path.cs
Quelle:
Path.cs

Gibt den Dateinamen und die Erweiterung eines Dateipfads zurück, der durch eine schreibgeschützte Zeichenspanne dargestellt wird.

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)

Parameter

path
ReadOnlySpan<Char>

Eine schreibgeschützte Spanne, die den Pfad enthält, aus dem der Dateiname und die Erweiterung abgerufen werden sollen.

Gibt zurück

Die Zeichen nach dem letzten Verzeichnistrennzeichen in path.

Hinweise

Die zurückgegebene schreibgeschützte Spanne enthält die Zeichen des Pfads, die dem letzten Trennzeichen in pathfolgen. Wenn das letzte Zeichen in path ein Volume- oder Verzeichnistrennzeichen ist, gibt die -Methode zurück ReadOnlySpan<T>.Empty. Wenn path kein Trennzeichen enthält, gibt die -Methode zurück path.

Weitere Informationen

Gilt für:

GetFileName(String)

Quelle:
Path.cs
Quelle:
Path.cs
Quelle:
Path.cs

Gibt den Dateinamen und die Erweiterung der angegebenen Pfadzeichenfolge zurück.

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

Parameter

path
String

Die Pfadzeichenfolge, aus der der Dateiname und die Erweiterung abgerufen werden sollen.

Gibt zurück

Die Zeichen nach dem letzten Verzeichnistrennzeichen in path. Wenn das letzte Zeichen von path ein Verzeichnis- bzw. Volumetrennzeichen ist, gibt diese Methode Empty zurück. Wenn path gleich null ist, gibt die Methode null zurück.

Ausnahmen

.NET Framework und .NET Core-Versionen älter als 2.1: path enthält mindestens ein ungültiges Zeichen, das in GetInvalidPathChars()definiert ist.

Beispiele

Im folgenden Beispiel wird das Verhalten der GetFileName -Methode auf einer Windows-basierten Desktopplattform veranschaulicht.

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 ''

Hinweise

Der zurückgegebene Wert ist null , wenn der Dateipfad lautet null.

Die Trennzeichen, die verwendet werden, um den Anfang des Dateinamens zu bestimmen, sind DirectorySeparatorChar und AltDirectorySeparatorChar.

Da \ ein legaler Dateiname unter Unix ist, GetFileName kann die Ausführung unter Unix-basierten Plattformen den Dateinamen von einem Windows-basierten Pfad wie C:\mydir\myfile.ext nicht ordnungsgemäß zurückgeben, aber GetFileName unter Windows-basierten Plattformen kann den Dateinamen ordnungsgemäß von einem Unix-basierten Pfad wie /tmp/myfile.ext zurückgeben, sodass das Verhalten der GetFileName Methode auf Unix- und Windows-basierten Plattformen nicht genau identisch ist.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für: