Path.GetFileName Método

Definição

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

Sobrecargas

Name Description
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>)

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 após o último caractere separador de diretórios em path.

Observações

O espaço de apenas leitura devolvido contém os caracteres do caminho que seguem o último separador em path. Se o último carácter em path for um carácter separador de volume ou diretório, o método devolve ReadOnlySpan<T>.Empty. Se path não contiver carácter separador, o método devolve path.

Ver também

Aplica-se a

GetFileName(String)

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);
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 após o último caractere separador de diretórios em path. Se o último carácter de path for um carácter de diretório ou separador de volume, este método devolve Empty. Se path for null, este método devolve 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.

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

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.

Ver também

Aplica-se a