Path.GetDirectoryName Path.GetDirectoryName Path.GetDirectoryName Path.GetDirectoryName Method

Definizione

Overload

GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>)

Restituisce le informazioni sulla directory per il percorso specificato rappresentato da un intervallo di caratteri.Returns the directory information for the specified path represented by a character span.

GetDirectoryName(String) GetDirectoryName(String) GetDirectoryName(String) GetDirectoryName(String)

Restituisce le informazioni sulla directory per la stringa di percorso specificata.Returns the directory information for the specified path string.

GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>)

Restituisce le informazioni sulla directory per il percorso specificato rappresentato da un intervallo di caratteri.Returns the directory information for the specified path represented by a character span.

public:
 static ReadOnlySpan<char> GetDirectoryName(ReadOnlySpan<char> path);
public static ReadOnlySpan<char> GetDirectoryName (ReadOnlySpan<char> path);
static member GetDirectoryName : ReadOnlySpan<char> -> ReadOnlySpan<char>
Public Shared Function GetDirectoryName (path As ReadOnlySpan(Of Char)) As ReadOnlySpan(Of Char)

Parametri

path
ReadOnlySpan<Char>

Percorso da cui recuperare le informazioni sulla directory.The path to retrieve the directory information from.

Restituisce

Informazioni sulla directory per path, o un intervallo vuoto se path è null, un intervallo vuoto o un percorso radice, ad esempio , C: o \server\share.Directory information for path, or an empty span if path is null, an empty span, or a root (such as , C:, or \server\share).

Commenti

A differenza dell'overload della stringa, questo metodo non normalizza i separatori di directory.Unlike the string overload, this method doesn't normalize directory separators.

Vedi anche

GetDirectoryName(String) GetDirectoryName(String) GetDirectoryName(String) GetDirectoryName(String)

Restituisce le informazioni sulla directory per la stringa di percorso specificata.Returns the directory information for the specified path string.

public:
 static System::String ^ GetDirectoryName(System::String ^ path);
public static string GetDirectoryName (string path);
static member GetDirectoryName : string -> string
Public Shared Function GetDirectoryName (path As String) As String

Parametri

path
String String String String

Percorso di un file o di una directory.The path of a file or directory.

Restituisce

Informazioni sulla directory per path o null se path indica una directory radice o è Null.Directory information for path, or null if path denotes a root directory or is null. Restituisce Empty se path non contiene informazioni sulla directory.Returns Empty if path does not contain directory information.

Eccezioni

Il parametro path contiene caratteri non validi, è vuoto o contiene solo spazi vuoti.The path parameter contains invalid characters, is empty, or contains only white spaces.

In .NET per app di Windows Store o nella libreria di classi portabile rilevare invece l'eccezione della classe di base, IOException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

La lunghezza del parametro path è maggiore della lunghezza massima definita nel sistema.The path parameter is longer than the system-defined maximum length.

Esempi

Nell'esempio seguente viene illustrato l' GetDirectoryName utilizzo del metodo in una piattaforma desktop basata su Windows.The following example demonstrates using the GetDirectoryName method on a Windows-based desktop platform.

String^ filePath = "C:\\MyDir\\MySubDir\\myfile.ext";
String^ directoryName;
int i = 0;

while (filePath != nullptr)
{
    directoryName = Path::GetDirectoryName(filePath);
    Console::WriteLine("GetDirectoryName('{0}') returns '{1}'",
        filePath, directoryName);
    filePath = directoryName;
    if (i == 1)
    {
        filePath = directoryName + "\\";  // this will preserve the previous path
    }
    i++;
}
/*
This code produces the following output:

GetDirectoryName('C:\MyDir\MySubDir\myfile.ext') returns 'C:\MyDir\MySubDir'
GetDirectoryName('C:\MyDir\MySubDir') returns 'C:\MyDir'
GetDirectoryName('C:\MyDir\') returns 'C:\MyDir'
GetDirectoryName('C:\MyDir') returns 'C:\'
GetDirectoryName('C:\') returns ''
*/
string filePath = @"C:\MyDir\MySubDir\myfile.ext";
string directoryName;
int i = 0;

while (filePath != null)
{
    directoryName = Path.GetDirectoryName(filePath);
    Console.WriteLine("GetDirectoryName('{0}') returns '{1}'",
        filePath, directoryName);
    filePath = directoryName;
    if (i == 1)
    {
        filePath = directoryName + @"\";  // this will preserve the previous path
    }
    i++;
}
/*
This code produces the following output:

GetDirectoryName('C:\MyDir\MySubDir\myfile.ext') returns 'C:\MyDir\MySubDir'
GetDirectoryName('C:\MyDir\MySubDir') returns 'C:\MyDir'
GetDirectoryName('C:\MyDir\') returns 'C:\MyDir'
GetDirectoryName('C:\MyDir') returns 'C:\'
GetDirectoryName('C:\') returns ''
*/
Dim filepath As String = "C:\MyDir\MySubDir\myfile.ext"
Dim directoryName As String
Dim i As Integer = 0

While filepath <> Nothing
    directoryName = Path.GetDirectoryName(filepath)
    Console.WriteLine("GetDirectoryName('{0}') returns '{1}'", _
        filepath, directoryName)
    filepath = directoryName
    If i = 1
       filepath = directoryName + "\"  ' this will preserve the previous path
    End If
    i = i + 1
End While

'This code produces the following output:
'
' GetDirectoryName('C:\MyDir\MySubDir\myfile.ext') returns 'C:\MyDir\MySubDir'
' GetDirectoryName('C:\MyDir\MySubDir') returns 'C:\MyDir'
' GetDirectoryName('C:\MyDir\') returns 'C:\MyDir'
' GetDirectoryName('C:\MyDir') returns 'C:\'
' GetDirectoryName('C:\') returns ''

Commenti

Nella maggior parte dei casi, la stringa restituita da questo metodo è costituita da tutti i caratteri nel percorso fino a DirectorySeparatorChar , AltDirectorySeparatorCharma non includendo l'ultimo o.In most cases, the string returned by this method consists of all characters in the path up to but not including the last DirectorySeparatorChar or AltDirectorySeparatorChar. Se il percorso è costituito da una directory radice, ad esempio "\c:", viene restituito null.If the path consists of a root directory, such as "c:\", null is returned. Si noti che questo metodo non supporta i percorsi che usano "file:".Note that this method does not support paths using "file:". Poiché il percorso restituito non include DirectorySeparatorChar o AltDirectorySeparatorChar, il passaggio del percorso GetDirectoryName restituito al metodo comporterà il troncamento di un livello di cartella per ogni chiamata successiva sulla stringa di risultato.Because the returned path does not include the DirectorySeparatorChar or AltDirectorySeparatorChar, passing the returned path back into the GetDirectoryName method will result in the truncation of one folder level per subsequent call on the result string. Se ad esempio si passa il percorso "C:\Directory\SubDirectory\test.txt" GetDirectoryName al metodo, viene restituito "c:\Directory\Sottodirectory".For example, passing the path "C:\Directory\SubDirectory\test.txt" into the GetDirectoryName method will return "C:\Directory\SubDirectory". Se si passa la stringa "c:\Directory\Sottodirectory" in GetDirectoryName , il risultato è "C:\Directory".Passing that string, "C:\Directory\SubDirectory", into GetDirectoryName will result in "C:\Directory".

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Si applica a