Path.GetFileName Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Przeciążenia

GetFileName(ReadOnlySpan<Char>)	Zwraca nazwę pliku i rozszerzenie ścieżki pliku reprezentowanej przez zakres znaków tylko do odczytu.
GetFileName(String)	Zwraca nazwę pliku i rozszerzenie określonego ciągu ścieżki.

GetFileName(ReadOnlySpan<Char>)

Źródło:

Path.cs

Zwraca nazwę pliku i rozszerzenie ścieżki pliku reprezentowanej przez zakres znaków tylko do odczytu.

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)

Parametry

path

ReadOnlySpan<Char>

Zakres tylko do odczytu zawierający ścieżkę, z której ma być uzyskiwana nazwa pliku i rozszerzenie.

Zwraca

ReadOnlySpan<Char>

Znaki po ostatnim znaku separatora katalogu w pliku path.

Uwagi

Zwrócony zakres tylko do odczytu zawiera znaki ścieżki, która następuje po ostatnim separatorze w pliku path. Jeśli ostatni znak w path pliku jest znakiem woluminu lub separatora katalogów, metoda zwraca wartość ReadOnlySpan<T>.Empty. Jeśli path nie zawiera znaku separatora, metoda zwraca wartość path.

Zobacz też

• Formaty ścieżek plików w systemie Windows

GetFileName(String)

Źródło:

Path.cs

Zwraca nazwę pliku i rozszerzenie określonego ciągu ścieżki.

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

Parametry

path

String

Ciąg ścieżki, z którego ma być uzyskiwana nazwa pliku i rozszerzenie.

Zwraca

String

Znaki po ostatnim znaku separatora katalogu w pliku path. Jeśli ostatni znak jest znakiem katalogu lub separatora woluminu path , ta metoda zwraca wartość Empty. Jeśli path parametr ma nullwartość , ta metoda zwraca wartość null.

Wyjątki

ArgumentException

.NET Framework i .NET Core w wersjach starszych niż 2.1: path zawiera co najmniej jeden z nieprawidłowych znaków zdefiniowanych w pliku GetInvalidPathChars().

Przykłady

W poniższym przykładzie pokazano zachowanie GetFileName metody na platformie klasycznej opartej na systemie Windows.

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

Uwagi

Zwrócona wartość to null , jeśli ścieżka pliku to null.

Znaki separatora używane do określenia początku nazwy pliku to DirectorySeparatorChar i AltDirectorySeparatorChar.

Ponieważ \ jest to nazwa pliku prawnego w systemie Unix, GetFileName uruchomienie na platformach opartych na systemie Unix nie może poprawnie zwrócić nazwy pliku ze ścieżki opartej na systemie Windows, takiej jak C:\mydir\myfile.ext, ale GetFileName uruchamianie na platformach opartych na systemie Windows może poprawnie zwrócić nazwę pliku ze ścieżki opartej na systemie Unix, takiej jak /tmp/myfile.ext, więc zachowanie GetFileName metody nie jest ściśle takie samo na platformach opartych na systemach Unix i Windows.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• Formaty ścieżek plików w systemie Windows
• We/wy plików i Stream
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku