Taal

Path.GetFileName Methode

Definitie

Naamruimte:
System.IO
Assembly's:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll
Assembly's:
mscorlib.dll, System.Runtime.Extensions.dll
Assembly:
mscorlib.dll

Overloads

Naam Description
GetFileName(ReadOnlySpan<Char>)

Retourneert de bestandsnaam en extensie van een bestandspad dat wordt vertegenwoordigd door een alleen-lezen tekenbereik.
GetFileName(String)

Retourneert de bestandsnaam en extensie van de opgegeven padtekenreeks.

GetFileName(ReadOnlySpan<Char>)

Bron:
Path.cs
Bron:
Path.cs
Bron:
Path.cs
Bron:
Path.cs
Bron:
Path.cs

Retourneert de bestandsnaam en extensie van een bestandspad dat wordt vertegenwoordigd door een alleen-lezen tekenbereik.

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)

Parameters

path
ReadOnlySpan<Char>

Een alleen-lezen periode die het pad bevat waaruit de bestandsnaam en extensie moeten worden opgehaald.

Retouren

ReadOnlySpan<Char>

De tekens die volgen op het laatste scheidingsteken van de map of de hoofdmap van path, afhankelijk van wat later komt.

Opmerkingen

Het geretourneerde bereik met het kenmerk Alleen-lezen bevat de tekens die path volgen op het laatste teken van het mapscheidingsteken of het einde van de hoofdmap van path (zoals geretourneerd door GetPathRoot), afhankelijk van wat er later wordt weergegeven. Als path het eindigt met een directoryscheidingsteken of alleen uit een hoofdmap bestaat, retourneert ReadOnlySpan<T>.Emptyde methode . Als path het geen directoryscheidingsteken of een hoofdmap bevat, retourneert pathde methode .

Op Windows kan de hoofdmap bijvoorbeeld een station of een UNC-share zijn. Zie bestandspadindelingen op Windows systemen voor andere hoofdindelingen, zoals DOS-apparaatpaden. In C:file.txt, de hoofdmap is C:, dus de bestandsnaam is file.txt. Een UNC-hoofdmap, zoals \\server\share mapscheidingstekens, maar ze maken deel uit van de hoofdmap en markeren het begin van de bestandsnaam niet. De bestandsnaam is \\server\share\file.txtfile.txtdus leeg en de bestandsnaam is \\server\share leeg, omdat het hele pad de hoofdmap is.

Zie ook

Van toepassing op

GetFileName(String)

Bron:
Path.cs
Bron:
Path.cs
Bron:
Path.cs
Bron:
Path.cs
Bron:
Path.cs

Retourneert de bestandsnaam en extensie van de opgegeven padtekenreeks.

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

Parameters

path
String

De padtekenreeks waaruit de bestandsnaam en extensie moeten worden opgehaald.

Retouren

String

De tekens die volgen op het laatste scheidingsteken voor mappen of de hoofdmap van, afhankelijk van pathwat later komt, of null als path dat het is null.

Uitzonderingen

ArgumentException

.NET Framework en .NET Core-versies ouder dan 2.1: path bevat een of meer ongeldige tekens die zijn gedefinieerd in GetInvalidPathChars().

Voorbeelden

In het volgende voorbeeld ziet u het gedrag van de methode GetFileName op een desktopplatform op basis van 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 ''

Opmerkingen

De geretourneerde waarde is null als het bestandspad is null.

De geretourneerde tekenreeks bevat de tekens van path die volgen op het laatste DirectorySeparatorChar teken of AltDirectorySeparatorChar het einde van de hoofdmap van path (zoals geretourneerd door GetPathRoot), afhankelijk van wat later komt. Als path het eindigt met een directoryscheidingsteken of alleen uit een hoofdmap bestaat, retourneert String.Emptyde methode . Als path het geen directoryscheidingsteken of een hoofdmap bevat, retourneert pathde methode .

Op Windows kan de hoofdmap bijvoorbeeld een station of een UNC-share zijn. Zie bestandspadindelingen op Windows systemen voor andere hoofdindelingen, zoals DOS-apparaatpaden. In C:file.txt, de hoofdmap is C:, dus de bestandsnaam is file.txt. Een UNC-hoofdmap, zoals \\server\share mapscheidingstekens, maar ze maken deel uit van de hoofdmap en markeren het begin van de bestandsnaam niet. De bestandsnaam is \\server\share\file.txtfile.txtdus leeg en de bestandsnaam is \\server\share leeg, omdat het hele pad de hoofdmap is.

Omdat \ een juridische bestandsnaam is op Unix, kan GetFileName die wordt uitgevoerd onder Unix-platforms de bestandsnaam niet correct retourneren van een pad op basis van Windows, zoals C:\mydir\myfile.ext, maar GetFileName die worden uitgevoerd onder op Windows gebaseerde platforms, kan de bestandsnaam correct retourneren van een Unix-pad, zoals /tmp/myfile.ext, het gedrag van de methode GetFileName is dus niet strikt hetzelfde op Unix- en Windows-platforms.

Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.

Zie ook

Van toepassing op