Idioma

Path.GetFileName Método

Definição

Namespace:
System.IO
Assemblies:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll
Assemblies:
mscorlib.dll, System.Runtime.Extensions.dll
Assembly:
mscorlib.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>)

Origem:
Path.cs
Origem:
Path.cs
Origem:
Path.cs
Origem:
Path.cs
Origem:
Path.cs

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 que seguem o último caractere separador de diretório ou a raiz de path, o que ocorrer mais tarde.

Comentários

O intervalo somente leitura retornado contém os caracteres que path seguem o último caractere separador de diretório ou o final da raiz de path (conforme retornado por GetPathRoot), o que vier mais tarde. Se path terminar com um caractere separador de diretório ou consistir apenas em uma raiz, o método retornará ReadOnlySpan<T>.Empty. Se path não contiver um caractere separador de diretório nem uma raiz, o método retornará path.

Em Windows, a raiz pode ser, por exemplo, uma unidade ou um compartilhamento UNC. Para outros formatos raiz, como os caminhos do dispositivo DOS, consulte formatos de caminho de arquivo em sistemas de Windows. Em C:file.txt, a raiz é C:, portanto, o nome do arquivo é file.txt. Uma raiz UNC, como \\server\share separadores de diretório, mas elas fazem parte da raiz e não marcam o início do nome do arquivo. Portanto, o nome \\server\share\file.txt do arquivo está file.txte o nome \\server\share do arquivo está vazio, porque o caminho inteiro é a raiz.

Confira também

Aplica-se a

GetFileName(String)

Origem:
Path.cs
Origem:
Path.cs
Origem:
Path.cs
Origem:
Path.cs
Origem:
Path.cs

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);
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 que seguem o último caractere separador de diretório ou a raiz de path, o que vier mais tarde ou null se path for 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.

A cadeia de caracteres retornada contém os caracteres que path seguem o último DirectorySeparatorChar ou AltDirectorySeparatorChar caractere ou o final da raiz de path (conforme retornado por GetPathRoot), o que vier mais tarde. Se path terminar com um caractere separador de diretório ou consistir apenas em uma raiz, o método retornará String.Empty. Se path não contiver um caractere separador de diretório nem uma raiz, o método retornará path.

Em Windows, a raiz pode ser, por exemplo, uma unidade ou um compartilhamento UNC. Para outros formatos raiz, como os caminhos do dispositivo DOS, consulte formatos de caminho de arquivo em sistemas de Windows. Em C:file.txt, a raiz é C:, portanto, o nome do arquivo é file.txt. Uma raiz UNC, como \\server\share separadores de diretório, mas elas fazem parte da raiz e não marcam o início do nome do arquivo. Portanto, o nome \\server\share\file.txt do arquivo está file.txte o nome \\server\share do arquivo está vazio, porque o caminho inteiro é a raiz.

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