Path.GetFileName Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

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

GetFileName(ReadOnlySpan<Char>)

Origem:

Path.cs

Retorna o nome de arquivo e a extensão de um caminho de arquivo que é 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 de 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 em path for 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

• Formatos de caminho de arquivo em sistemas Windows

GetFileName(String)

Origem:

Path.cs

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

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 do caminho do qual o nome do arquivo e a extensão serão obtidos.

Retornos

String

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

Exceções

ArgumentException

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

Exemplos

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

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 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 em execução em plataformas baseadas no Windows pode retornar corretamente o nome do arquivo de um caminho baseado em Unix como /tmp/myfile.ext, portanto, o comportamento do GetFileName método não é estritamente o mesmo em plataformas baseadas no Unix e no Windows.

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

Confira também

• Formatos de caminho de arquivo em sistemas Windows
• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo