Path.GetFileName Methode

Definition

Namespace:: System.IO

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: netstandard.dll

Assemblys:: mscorlib.dll, System.Runtime.Extensions.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

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

Quelle:: Path.cs

Quelle:: Path.cs

Quelle:: Path.cs

Quelle:: Path.cs

Quelle:: Path.cs

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, die dem letzten Verzeichnistrennzeichen oder dem Stammzeichen folgen path, je nachdem, welches später kommt.

Hinweise

Die zurückgegebene schreibgeschützte Spanne enthält die Zeichen, die path entweder dem letzten Verzeichnistrennzeichen oder dem Ende des Stamms ( path wie zurückgegeben von GetPathRoot) folgen, je nachdem, welches später kommt. Wenn path sie mit einem Verzeichnistrennzeichen endet oder nur aus einem Stamm besteht, gibt die Methode zurück ReadOnlySpan<T>.Empty. Wenn path weder ein Verzeichnistrennzeichen noch ein Stammzeichen enthalten ist, gibt die Methode zurück path.

Bei Windows kann der Stamm z. B. ein Laufwerk oder eine UNC-Freigabe sein. Weitere Stammformate, z. B. DOS-Gerätepfade, finden Sie unter Dateipfadformate auf Windows Systemen. In C:file.txt, the root is C:, so the file name is file.txt. Ein UNC-Stamm, z \\server\share . B. Verzeichnistrennzeichen, aber sie sind Teil des Stammes und markieren nicht den Anfang des Dateinamens. Der Dateiname \\server\share\file.txt ist also , file.txtund der Dateiname \\server\share ist leer, da der gesamte Pfad der Stamm ist.

Siehe auch

File-Pfadformate auf Windows Systemen

Gilt für:

GetFileName(String)

Quelle:: Path.cs

Quelle:: Path.cs

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

String

Die Zeichen, die dem letzten Verzeichnistrennzeichen oder dem Stammzeichen pathfolgen , je nachdem, was später kommt, oder null wenn path ja 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 zurückgegebene Zeichenfolge enthält die Zeichen, die path entweder dem letzten DirectorySeparatorChar zeichen oder AltDirectorySeparatorChar dem Ende des Stamms path folgen (wie zurückgegeben von GetPathRoot), je nachdem, welches später kommt. Wenn path sie mit einem Verzeichnistrennzeichen endet oder nur aus einem Stamm besteht, gibt die Methode zurück String.Empty. Wenn path weder ein Verzeichnistrennzeichen noch ein Stammzeichen enthalten ist, gibt die Methode zurück path.

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

Siehe auch

Gilt für:

Feedback

War diese Seite hilfreich?