Path.GetFileName Metoda

Definicja

Przeciążenia

GetFileName(ReadOnlySpan<Char>)

Zwraca nazwę pliku i rozszerzenie ścieżki pliku reprezentowanej przez zakres znaków tylko do odczytu.Returns the file name and extension of a file path that is represented by a read-only character span.

GetFileName(String)

Zwraca nazwę pliku i rozszerzenie określonego ciągu ścieżki.Returns the file name and extension of the specified path string.

GetFileName(ReadOnlySpan<Char>)

Zwraca nazwę pliku i rozszerzenie ścieżki pliku reprezentowanej przez zakres znaków tylko do odczytu.Returns the file name and extension of a file path that is represented by a read-only character span.

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, który zawiera ścieżkę, z której ma zostać uzyskana nazwa i rozszerzenie pliku.A read-only span that contains the path from which to obtain the file name and extension.

Zwraca

Znaki po ostatnim znaku separatora katalogu w path.The characters after the last directory separator character in path.

Uwagi

Zwrócony zakres tylko do odczytu zawiera znaki ścieżki, które obserwują ostatni separator w path.The returned read-only span contains the characters of the path that follow the last separator in path. Jeśli ostatni znak w path jest znakiem separatora woluminu lub katalogu, metoda zwraca ReadOnlySpan<T>.Empty.If the last character in path is a volume or directory separator character, the method returns ReadOnlySpan<T>.Empty. Jeśli path nie zawiera znaku separatora, metoda zwraca path.If path contains no separator character, the method returns path.

Zobacz też

GetFileName(String)

Zwraca nazwę pliku i rozszerzenie określonego ciągu ścieżki.Returns the file name and extension of the specified path string.

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 zostać uzyskana nazwa i rozszerzenie pliku.The path string from which to obtain the file name and extension.

Zwraca

Znaki po ostatnim znaku separatora katalogu w path.The characters after the last directory separator character in path. Jeśli ostatni znak path jest znakiem separatora katalogu lub woluminu, ta metoda zwraca Empty.If the last character of path is a directory or volume separator character, this method returns Empty. Jeśli path jest null, ta metoda zwraca null.If path is null, this method returns null.

Wyjątki

path zawiera jeden lub więcej nieprawidłowych znaków zdefiniowanych w GetInvalidPathChars().path contains one or more of the invalid characters defined in GetInvalidPathChars().

Przykłady

Poniższy przykład ilustruje zachowanie metody GetFileName na platformie pulpitu opartej na systemie Windows.The following example demonstrates the behavior of the GetFileName method on a Windows-based desktop platform.

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

Zwracana wartość jest null, jeśli ścieżka pliku jest null.The returned value is null if the file path is null.

Znaki separatora używane do określenia początku nazwy pliku są DirectorySeparatorChar i AltDirectorySeparatorChar.The separator characters used to determine the start of the file name are DirectorySeparatorChar and AltDirectorySeparatorChar.

Ponieważ \ jest legalną nazwą pliku w systemie Unix, GetFileName uruchomione w ramach platform opartych na systemie UNIX nie mogą poprawnie zwrócić nazwy pliku z ścieżki opartej na systemie Windows, takiej jak C:\mydir\plik. ext, ale GetFileName działające w ramach platform opartych na systemie Windows, może poprawnie zwrócić nazwę pliku z ścieżki opartej na systemie UNIX, na przykład /tmp/myfile.ext, więc zachowanie metody GetFileName nie jest ściśle takie samo na platformach opartych na systemieBecause \ is a legal file name on Unix, GetFileName running under Unix-based platforms cannot correctly return the file name from a Windows-based path like C:\mydir\myfile.ext, but GetFileName running under Windows-based platforms can correctly return the file name from a Unix-based path like /tmp/myfile.ext, so the behavior of the GetFileName method is not strictly the same on Unix-based and Windows-based platforms.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Dotyczy