Path.GetFileName Methode

Definition

Namespace:
System.IO
Assembly:
netstandard.dll
Assemblys:
mscorlib.dll, System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.Extensions.dll

Überlädt

Name Beschreibung
GetFileName(ReadOnlySpan<Char>)

Gibt den Dateinamen und die Erweiterung eines Dateipfads zurück, der durch einen schreibgeschützten Zeichenbereich dargestellt wird.
GetFileName(String)

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

GetFileName(ReadOnlySpan<Char>)

Gibt den Dateinamen und die Erweiterung eines Dateipfads zurück, der durch einen schreibgeschützten Zeichenbereich 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

ReadOnlySpan<Char>

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 folgen in path. Wenn das letzte Zeichen path ein Volume- oder Verzeichnistrennzeichen ist, gibt die Methode zurück ReadOnlySpan<T>.Empty. Wenn path kein Trennzeichen vorhanden ist, gibt pathdie Methode zurück.

Weitere Informationen

Gilt für:

GetFileName(String)

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);
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

String

Die Zeichen nach dem letzten Verzeichnistrennzeichen in path. Wenn es sich bei dem letzten Zeichen um path ein Verzeichnis- oder Volumetrennzeichen handelt, wird diese Methode zurückgegeben Empty. Ist path dies der Fall null, gibt diese Methode zurück null.

Ausnahmen

ArgumentException

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

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

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 ist null.

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

Da \ ein rechtlicher Dateiname auf Unix ist, können GetFileName, die unter Unix-basierten Plattformen ausgeführt werden, den Dateinamen nicht ordnungsgemäß von einem Windows-basierten Pfad wie C:\mydir\myfile.ext zurückgeben. aber GetFileName unter Windows-basierten Plattformen ausgeführt werden, können den Dateinamen ordnungsgemäß von einem Unix-basierten Pfad wie /tmp/myfile.ext zurückgeben, daher ist das Verhalten der GetFileName-Methode nicht streng gleich auf Unix-basierten und Windows-basierten Plattformen.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für: