Path.GetFileName Path.GetFileName Path.GetFileName Path.GetFileName Method

Definição

Sobrecargas

GetFileName(ReadOnlySpan<Char>) GetFileName(ReadOnlySpan<Char>) GetFileName(ReadOnlySpan<Char>) GetFileName(ReadOnlySpan<Char>)

Retorna o nome de arquivo e a extensão de um caminho de arquivo que é representado por um intervalo de caracteres somente leitura.Returns the file name and extension of a file path that is represented by a read-only character span.

GetFileName(String) GetFileName(String) GetFileName(String) GetFileName(String)

Retorna o nome de arquivo e a extensão da cadeia de caracteres do caminho especificado.Returns the file name and extension of the specified path string.

GetFileName(ReadOnlySpan<Char>) GetFileName(ReadOnlySpan<Char>) GetFileName(ReadOnlySpan<Char>) GetFileName(ReadOnlySpan<Char>)

Retorna o nome de arquivo e a extensão de um caminho de arquivo que é representado por um intervalo de caracteres somente leitura.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)

Parâmetros

path
ReadOnlySpan<Char>

Um intervalo somente leitura que contém o caminho do qual obter o nome de arquivo e a extensão.A read-only span that contains the path from which to obtain the file name and extension.

Retornos

Os caracteres após o último caractere separador de diretório em path.The characters after the last directory separator character in path.

Comentários

O span somente leitura retornado contém os caracteres do caminho que seguem o último separador path.The returned read-only span contains the characters of the path that follow the last separator in path. Se o último caractere no path for um caractere separador de volume ou diretório, ReadOnlySpan<T>.Emptyo método retornará.If the last character in path is a volume or directory separator character, the method returns ReadOnlySpan<T>.Empty. Se path não contiver nenhum caractere separador path, o método retornará.If path contains no separator character, the method returns path.

Veja também

GetFileName(String) GetFileName(String) GetFileName(String) GetFileName(String)

Retorna o nome de arquivo e a extensão da cadeia de caracteres do caminho especificado.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

Parâmetros

path
String String String String

A cadeia de caracteres do caminho do qual o nome do arquivo e a extensão serão obtidos.The path string from which to obtain the file name and extension.

Retornos

Os caracteres após o último caractere separador de diretório em path.The characters after the last directory separator character in path. Se o último caractere de path for um caractere de separador de diretório ou volume, esse método retornará Empty.If the last character of path is a directory or volume separator character, this method returns Empty. Se path for null, esse método retornará null.If path is null, this method returns null.

Exceções

path contém um ou mais caracteres inválidos definidos em GetInvalidPathChars().path contains one or more of the invalid characters defined in GetInvalidPathChars().

Exemplos

O exemplo a seguir demonstra o comportamento do GetFileName método em uma plataforma de área de trabalho baseada no 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 ''

Comentários

O valor retornado é null se o caminho do arquivo nullfor.The returned value is null if the file path is null.

Os caracteres separadores usados para determinar o início do nome do DirectorySeparatorChar arquivo AltDirectorySeparatorCharsão e.The separator characters used to determine the start of the file name are DirectorySeparatorChar and AltDirectorySeparatorChar.

Como \ é um nome de arquivo legal no UNIX GetFileName , a execução em plataformas baseadas em Unix não pode retornar corretamente o nome do arquivo de um caminho baseado no Windows como C:\mydir\MyFile. ext, mas GetFileName a execução em plataformas baseadas no Windows pode retornar corretamente o nome de arquivo de um caminho baseado em UNIX como /tmp/MyFile.ext, portanto, o GetFileName comportamento do método não é estritamente o mesmo em plataformas baseadas em UNIX e Windows.Because \ 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.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Veja também

Aplica-se a