Path.GetFileName Método

Definição

Namespace:
System.IO
Assembly:
netstandard.dll
Assemblies:
mscorlib.dll, System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.Extensions.dll

Sobrecargas

Nome Description
GetFileName(ReadOnlySpan<Char>)

Retorna o nome do arquivo e a extensão de um caminho de arquivo representado por um intervalo de caracteres somente leitura.
GetFileName(String)

Retorna o nome do arquivo e a extensão da cadeia de caracteres de caminho especificada.

GetFileName(ReadOnlySpan<Char>)

Retorna o nome do arquivo e a extensão de um caminho de arquivo representado por um intervalo de caracteres somente leitura.

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 do arquivo e a extensão.

Retornos

ReadOnlySpan<Char>

Os caracteres após o último caractere separador de diretório em path.

Comentários

O intervalo somente leitura retornado contém os caracteres do caminho que seguem o último separador em path. Se o último caractere for path um caractere separador de volume ou diretório, o método retornará ReadOnlySpan<T>.Empty. Se path não contiver nenhum caractere separador, o método retornará path.

Confira também

Aplica-se a

GetFileName(String)

Retorna o nome do arquivo e a extensão da cadeia de caracteres de caminho especificada.

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

A cadeia de caracteres de caminho da qual obter o nome do arquivo e a extensão.

Retornos

String

Os caracteres após o último caractere separador de diretório em path. Se o último caractere for um caractere separador de path volume ou diretório, esse método retornará Empty. Se path for null, esse método retornará null.

Exceções

ArgumentException

Versões do .NET Framework e do .NET Core com mais de 2.1: path contém um ou mais dos caracteres inválidos definidos em GetInvalidPathChars().

Exemplos

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

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 será null se o caminho do arquivo for null.

Os caracteres separadores usados para determinar o início do nome do arquivo são DirectorySeparatorChar e AltDirectorySeparatorChar.

Como \ é um nome de arquivo legal no Unix, GetFileName em execução em plataformas baseadas em Unix não podem retornar corretamente o nome do arquivo de um caminho baseado em Windows, como C:\mydir\myfile.ext, mas GetFileName em execução em plataformas baseadas em Windows pode retornar corretamente o nome do arquivo de um caminho baseado em Unix, como /tmp/myfile.ext, portanto, o comportamento do método GetFileName não é estritamente o mesmo em plataformas baseadas em Unix e Windows.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a