Idioma

Path.GetFileName Método

Definição

Espaço de Nomes:
System.IO
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.Extensions.dll
Assemblagem:
netstandard.dll
Assemblagens:
mscorlib.dll, System.Runtime.Extensions.dll
Assemblagem:
mscorlib.dll

Sobrecargas

Nome Descrição
GetFileName(ReadOnlySpan<Char>)

Devolve o nome do ficheiro e a extensão de um caminho de ficheiro que é representado por um espaço de caracteres apenas de leitura.
GetFileName(String)

Devolve o nome do ficheiro e a extensão da cadeia de caminho especificada.

GetFileName(ReadOnlySpan<Char>)

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

Devolve o nome do ficheiro e a extensão de um caminho de ficheiro que é representado por um espaço de caracteres apenas de 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 span de apenas leitura que contém o caminho a partir do qual obter o nome e a extensão do ficheiro.

Devoluções

ReadOnlySpan<Char>

Os caracteres que seguem o último carácter separador de diretórios ou a raiz de path, o que ocorrer mais tarde.

Observações

O span de apenas leitura devolvido contém os caracteres de path que seguem ou o último carácter separador de diretórios ou o fim da raiz de path (conforme devolvido por GetPathRoot), o que ocorrer mais tarde. Se path terminar com um carácter separador de diretórios ou consistir apenas numa raiz, o método devolve ReadOnlySpan<T>.Empty. Se path não contiver nenhum carácter separador de diretórios nem uma raiz, o método devolve path.

No Windows, a raiz pode ser, por exemplo, uma unidade ou uma partilha UNC. Para outros formatos raiz, como caminhos de dispositivo DOS, veja Formatos de caminho de ficheiro em sistemas Windows. Em C:file.txt, a raiz é C:, pelo que o nome do ficheiro é file.txt. Uma raiz UNC, como contém \\server\share separadores de diretório, mas que fazem parte da raiz e não marcam o início do nome do ficheiro. Assim, o nome do ficheiro em \\server\share\file.txt é file.txt, e o nome do ficheiro em \\server\share está vazio, porque todo o caminho é a raiz.

Consulte também

Aplica-se a

GetFileName(String)

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

Devolve o nome do ficheiro e a extensão da cadeia 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 caminho a partir da qual obter o nome e a extensão do ficheiro.

Devoluções

String

Os caracteres que seguem o último carácter separador de diretórios ou a raiz de path, o que vier depois, ou null se path for null.

Exceções

ArgumentException

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

Exemplos

O exemplo seguinte demonstra o comportamento do método GetFileName numa plataforma de ambiente 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 ''

Observações

O valor devolvido é null se o caminho do ficheiro for null.

A cadeia devolvida contém os caracteres de path que seguem o último DirectorySeparatorChar ou AltDirectorySeparatorChar o caractere, ou o fim da raiz de path (como devolvido por GetPathRoot), o que ocorrer depois. Se path terminar com um carácter separador de diretórios ou consistir apenas numa raiz, o método devolve String.Empty. Se path não contiver nenhum carácter separador de diretórios nem uma raiz, o método devolve path.

No Windows, a raiz pode ser, por exemplo, uma unidade ou uma partilha UNC. Para outros formatos raiz, como caminhos de dispositivo DOS, veja Formatos de caminho de ficheiro em sistemas Windows. Em C:file.txt, a raiz é C:, pelo que o nome do ficheiro é file.txt. Uma raiz UNC, como contém \\server\share separadores de diretório, mas que fazem parte da raiz e não marcam o início do nome do ficheiro. Assim, o nome do ficheiro em \\server\share\file.txt é file.txt, e o nome do ficheiro em \\server\share está vazio, porque todo o caminho é a raiz.

Como \ é um nome de ficheiro legal no Unix, GetFileName a correr em plataformas baseadas em Unix não conseguem devolver corretamente o nome do ficheiro a partir de um caminho baseado em Windows como C:\mydir\myfile.ext, mas GetFileName a correr em plataformas baseadas em Windows pode devolver corretamente o nome do ficheiro a partir de um caminho baseado em Unix como /tmp/myfile.ext, assim, o comportamento do método GetFileName não é estritamente o mesmo em plataformas baseadas em Unix e em Windows.

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

Consulte também

Aplica-se a