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

定義

オーバーロード

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

文字範囲で表された、指定されたパスのディレクトリ情報を返します。Returns the directory information for the specified path represented by a character span.

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

指定したパス文字列のディレクトリ情報を返します。Returns the directory information for the specified path string.

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

文字範囲で表された、指定されたパスのディレクトリ情報を返します。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)

パラメーター

戻り値

path のディレクトリ情報。pathnull、空の範囲、またはルート (, C:、または \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).

こちらもご覧ください

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

指定したパス文字列のディレクトリ情報を返します。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

パラメーター

path
String String String String

ファイルまたはディレクトリのパス。The path of a file or directory.

戻り値

path のディレクトリ情報。path がルート ディレクトリを示しているか null である場合は nullDirectory information for path, or null if path denotes a root directory or is null. path にディレクトリ情報が含まれていない場合は、Empty を返します。Returns Empty if path does not contain directory information.

例外

path パラメーターは正しくない文字を含んでおり、空か、空白のみで構成されています。The path parameter contains invalid characters, is empty, or contains only white spaces.

Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である IOException を代わりにキャッチします。In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

path パラメーターは、システムで定義された最大長を超えています。The path parameter is longer than the system-defined maximum length.

次の例を使用して、 GetDirectoryName 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 ''

注釈

最後に、パスのすべての文字のほとんどの場合、このメソッドによって返される文字列がで構成されています。DirectorySeparatorCharまたはAltDirectorySeparatorCharします。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. パスがルート ディレクトリのなどはかどうかは"c:\"、null が返されます。If the path consists of a root directory, such as "c:\", null is returned. このメソッドを使用してパスをサポートしていないことに注意してください"ファイル:"です。Note that this method does not support paths using "file:". 返されるパスが含まれていないため、DirectorySeparatorCharまたはAltDirectorySeparatorCharに返されるパスを渡して、GetDirectoryNameメソッドは、結果の文字列で後続の呼び出しごとに 1 つのフォルダー レベルの切り捨てが発生します。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. たとえば、"C:\Directory\SubDirectory\test.txt"パスを渡すことに、GetDirectoryNameメソッドは"C:\Directory\SubDirectory"を返します。For example, passing the path "C:\Directory\SubDirectory\test.txt" into the GetDirectoryName method will return "C:\Directory\SubDirectory". "C:\Directory\SubDirectory"は、その文字列を渡すことGetDirectoryName"C:\Directory"になります。Passing that string, "C:\Directory\SubDirectory", into GetDirectoryName will result in "C:\Directory".

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

適用対象