Path.GetFileName Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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

ReadOnlySpan<Char>

Die Zeichen nach dem letzten Verzeichnistrennzeichen in path.

Hinweise

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

Siehe auch

Formate von Dateipfaden unter Windows-Systemen

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

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

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path enthält mindestens eine der ungültigen Zeichen, die 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 ''

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

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

Da \ es sich um einen rechtlichen Dateinamen auf Unix handelt, GetFileName können die Unter Unix-basierten Plattformen nicht ordnungsgemäß den Dateinamen aus einem Windows basierten Pfad wie C:\mydirmyfile.ext\ zurückgeben, aber GetFileName unter Windows basierenden Plattformen können den Dateinamen von einem Unix-basierten Pfad wie /tmp/myfile.ext ordnungsgemäß zurückgeben, sodass das Verhalten der GetFileName Methode nicht streng auf Unix-basierten und Windows basierten Plattformen.

Eine Liste allgemeiner I/O-Aufgaben finden Sie unter "Allgemeine I/O-Aufgaben".

Siehe auch

Gilt für: