Språk

Path.GetFileName Metod

Definition

Namnområde:
System.IO
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.Extensions.dll
Sammansättning:
netstandard.dll
Sammansättningar:
mscorlib.dll, System.Runtime.Extensions.dll
Sammansättning:
mscorlib.dll

Överlagringar

Name Description
GetFileName(ReadOnlySpan<Char>)

Returnerar filnamnet och filnamnstillägget för en filsökväg som representeras av ett skrivskyddat teckenintervall.
GetFileName(String)

Returnerar filnamnet och tillägget för den angivna sökvägssträngen.

GetFileName(ReadOnlySpan<Char>)

Källa:
Path.cs
Källa:
Path.cs
Källa:
Path.cs
Källa:
Path.cs
Källa:
Path.cs

Returnerar filnamnet och filnamnstillägget för en filsökväg som representeras av ett skrivskyddat teckenintervall.

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)

Parametrar

path
ReadOnlySpan<Char>

Ett skrivskyddat spann som innehåller sökvägen som filnamnet och filtillägget ska hämtas från.

Returer

ReadOnlySpan<Char>

De tecken som följer det sista katalogavgränsartecknet eller roten för path, beroende på vilket som kommer senare.

Kommentarer

Det returnerade skrivskyddade intervallet innehåller tecknen path i som följer antingen det sista katalogavgränsartecknet eller slutet av roten för path (som returneras av GetPathRoot), beroende på vilket som kommer senare. Om path slutar med ett katalogavgränsartecken eller endast består av en rot returnerar ReadOnlySpan<T>.Emptymetoden . Om path innehåller varken ett katalogavgränsartecken eller en rot returnerar pathmetoden .

På Windows kan roten till exempel vara en enhet eller en UNC-resurs. Andra rotformat, till exempel DOS-enhetssökvägar, finns i Filsökvägsformat på Windows system. I C:file.txtär C:roten , så filnamnet är file.txt. En UNC-rot som \\server\share innehåller katalogavgränsare, men de är en del av roten och markerar inte början på filnamnet. Filnamnet i \\server\share\file.txt är file.txtalltså , och filnamnet i \\server\share är tomt, eftersom hela sökvägen är roten.

Se även

Gäller för

GetFileName(String)

Källa:
Path.cs
Källa:
Path.cs
Källa:
Path.cs
Källa:
Path.cs
Källa:
Path.cs

Returnerar filnamnet och tillägget för den angivna sökvägssträngen.

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

Parametrar

path
String

Sökvägssträngen som filnamnet och filtillägget ska hämtas från.

Returer

String

De tecken som följer det sista katalogavgränsartecknet eller roten för path, beroende på vilket som kommer senare eller null om path är null.

Undantag

ArgumentException

.NET Framework- och .NET Core-versioner som är äldre än 2.1: path innehåller ett eller flera av de ogiltiga tecken som definierats i GetInvalidPathChars().

Exempel

I följande exempel visas beteendet för metoden GetFileName på en Windows-baserad skrivbordsplattform.

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 ''

Kommentarer

Det returnerade värdet är null om filsökvägen är null.

Den returnerade strängen innehåller tecknen path i som följer antingen det sista eller AltDirectorySeparatorChar det sista DirectorySeparatorChar tecknet eller slutet av roten av path (som returneras av GetPathRoot), beroende på vilket som kommer senare. Om path slutar med ett katalogavgränsartecken eller endast består av en rot returnerar String.Emptymetoden . Om path innehåller varken ett katalogavgränsartecken eller en rot returnerar pathmetoden .

På Windows kan roten till exempel vara en enhet eller en UNC-resurs. Andra rotformat, till exempel DOS-enhetssökvägar, finns i Filsökvägsformat på Windows system. I C:file.txtär C:roten , så filnamnet är file.txt. En UNC-rot som \\server\share innehåller katalogavgränsare, men de är en del av roten och markerar inte början på filnamnet. Filnamnet i \\server\share\file.txt är file.txtalltså , och filnamnet i \\server\share är tomt, eftersom hela sökvägen är roten.

Eftersom \ är ett juridiskt filnamn på Unix kan GetFileName som körs under Unix-baserade plattformar inte korrekt returnera filnamnet från en Windows-baserad sökväg som C:\mydir\myfile.ext, men GetFileName som körs under Windows-baserade plattformar kan korrekt returnera filnamnet från en Unix-baserad sökväg som /tmp/myfile.ext, så beteendet för metoden GetFileName är inte helt detsamma på Unix-baserade och Windows-baserade plattformar.

En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.

Se även

Gäller för