Lingua

Path.GetFileName Metodo

Definizione

Spazio dei nomi:
System.IO
Assembly:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll, System.Runtime.Extensions.dll
Assembly:
mscorlib.dll

Overload

Nome Descrizione
GetFileName(ReadOnlySpan<Char>)

Restituisce il nome file e l'estensione di un percorso di file rappresentato da un intervallo di caratteri di sola lettura.
GetFileName(String)

Restituisce il nome e l'estensione del file della stringa di percorso specificata.

GetFileName(ReadOnlySpan<Char>)

Origine:
Path.cs
Origine:
Path.cs
Origine:
Path.cs
Origine:
Path.cs
Origine:
Path.cs

Restituisce il nome file e l'estensione di un percorso di file rappresentato da un intervallo di caratteri di sola lettura.

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)

Parametri

path
ReadOnlySpan<Char>

Intervallo di sola lettura che contiene il percorso da cui ottenere il nome e l'estensione del file.

Valori restituiti

ReadOnlySpan<Char>

Caratteri che seguono l'ultimo carattere separatore di directory o la radice di path, a qualsiasi punto successivo.

Commenti

L'intervallo di sola lettura restituito contiene i caratteri di path che seguono l'ultimo carattere separatore di directory o la fine della radice di path (come restituito da GetPathRoot), a qualunque punto venga successivamente restituito. Se path termina con un carattere separatore di directory o è costituito solo da una radice, il metodo restituisce ReadOnlySpan<T>.Empty. Se path non contiene né un carattere separatore di directory né una radice, il metodo restituisce path.

In Windows, la radice può essere, ad esempio, un'unità o una condivisione UNC. Per altri formati radice, ad esempio i percorsi dei dispositivi DOS, vedere Formati di percorso dei file nei sistemi Windows. In C:file.txtla radice è C:, quindi il nome del file è file.txt. Una radice UNC, ad \\server\share esempio contiene separatori di directory, ma fa parte della radice e non contrassegna l'inizio del nome del file. Il nome del file in \\server\share\file.txt è file.txtquindi e il nome del file in \\server\share è vuoto, perché l'intero percorso è la radice.

Vedi anche

Si applica a

GetFileName(String)

Origine:
Path.cs
Origine:
Path.cs
Origine:
Path.cs
Origine:
Path.cs
Origine:
Path.cs

Restituisce il nome e l'estensione del file della stringa di percorso specificata.

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

Parametri

path
String

Stringa di percorso da cui ottenere il nome e l'estensione del file.

Valori restituiti

String

Caratteri che seguono l'ultimo carattere separatore di directory o la radice di path, a qualsiasi punto successivo o null se path è null.

Eccezioni

ArgumentException

.NET Framework e versioni di .NET Core precedenti alla 2.1: path contiene uno o più caratteri non validi definiti in GetInvalidPathChars().

Esempio

L'esempio seguente illustra il comportamento del metodo GetFileName su una piattaforma desktop basata su 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 ''

Commenti

Il valore restituito è null se il percorso del file è null.

La stringa restituita contiene i caratteri di path che seguono l'ultimo DirectorySeparatorChar o AltDirectorySeparatorChar il carattere o la fine della radice di path (come restituito da GetPathRoot), a qualsiasi passaggio successivo. Se path termina con un carattere separatore di directory o è costituito solo da una radice, il metodo restituisce String.Empty. Se path non contiene né un carattere separatore di directory né una radice, il metodo restituisce path.

In Windows, la radice può essere, ad esempio, un'unità o una condivisione UNC. Per altri formati radice, ad esempio i percorsi dei dispositivi DOS, vedere Formati di percorso dei file nei sistemi Windows. In C:file.txtla radice è C:, quindi il nome del file è file.txt. Una radice UNC, ad \\server\share esempio contiene separatori di directory, ma fa parte della radice e non contrassegna l'inizio del nome del file. Il nome del file in \\server\share\file.txt è file.txtquindi e il nome del file in \\server\share è vuoto, perché l'intero percorso è la radice.

Poiché \ è un nome di file legale in Unix, GetFileName in esecuzione in piattaforme basate su Unix non può restituire correttamente il nome del file da un percorso basato su Windows come C:\mydir\myfile.ext ma GetFileName in esecuzione in piattaforme basate su Windows possono restituire correttamente il nome del file da un percorso basato su Unix come /tmp/myfile.ext pertanto il comportamento del metodo GetFileName non è strettamente uguale su piattaforme basate su Unix e Windows.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a