DirectoryInfo.CreateSubdirectory メソッド

定義

指定したパスにサブディレクトリまたはサブディレクトリを作成します。 指定したパスは、 DirectoryInfo クラスのこのインスタンスからの相対パスにすることができます。

オーバーロード

名前 説明
CreateSubdirectory(String)

指定したパスにサブディレクトリまたはサブディレクトリを作成します。 指定したパスは、 DirectoryInfo クラスのこのインスタンスからの相対パスにすることができます。

CreateSubdirectory(String, DirectorySecurity)

指定したセキュリティを使用して、指定したパスにサブディレクトリまたはサブディレクトリを作成します。 指定したパスは、 DirectoryInfo クラスのこのインスタンスからの相対パスにすることができます。

CreateSubdirectory(String)

指定したパスにサブディレクトリまたはサブディレクトリを作成します。 指定したパスは、 DirectoryInfo クラスのこのインスタンスからの相対パスにすることができます。

public:
 System::IO::DirectoryInfo ^ CreateSubdirectory(System::String ^ path);
public System.IO.DirectoryInfo CreateSubdirectory(string path);
member this.CreateSubdirectory : string -> System.IO.DirectoryInfo
Public Function CreateSubdirectory (path As String) As DirectoryInfo

パラメーター

path
String

指定したパス。 これは、別のディスク ボリュームまたは汎用名前付け規則 (UNC) 名にすることはできません。

返品

pathで指定された最後のディレクトリ。

例外

path では、有効なファイル パスが指定されていないか、無効な DirectoryInfo 文字が含まれています。

pathnullです。

マップされていないドライブ上など、指定されたパスが無効です。

サブディレクトリを作成できません。

-または-

ファイルには、 pathで指定された名前が既に含まれています。

指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。

呼び出し元には、ディレクトリを作成するためのコード アクセス許可がありません。

-または-

呼び出し元には、返された DirectoryInfo オブジェクトによって記述されたディレクトリを読み取るコード アクセス許可がありません。 これは、 path パラメーターで既存のディレクトリが記述されている場合に発生する可能性があります。

path には、コロン文字 (ドライブ ラベル ("C:\") の一部ではない:)) が含まれています。

次の例では、サブディレクトリの作成を示します。 この例では、作成されたディレクトリは作成後に削除されます。 したがって、このサンプルをテストするには、コード内の削除行をコメント アウトします。

using System;
using System.IO;

public class CreateSubTest
{
    public static void Main()
    {
        // Create a reference to a directory.
        DirectoryInfo di = new DirectoryInfo("TempDir");

        // Create the directory only if it does not already exist.
        if (!di.Exists)
            di.Create();

        // Create a subdirectory in the directory just created.
        DirectoryInfo dis = di.CreateSubdirectory("SubDir");

        // Process that directory as required.
        // ...

        // Delete the subdirectory.
        dis.Delete(true);

        // Delete the directory.
        di.Delete(true);
    }
}
open System.IO

// Create a reference to a directory.
let di = DirectoryInfo "TempDir"

// Create the directory only if it does not already exist.
if not di.Exists then
    di.Create()

// Create a subdirectory in the directory just created.
let dis = di.CreateSubdirectory "SubDir"

// Process that directory as required.
// ...

// Delete the subdirectory.
dis.Delete true

// Delete the directory.
di.Delete true
Imports System.IO

Public Class CreateSubTest

    Public Shared Sub Main()
        ' Make a reference to a directory.
        Dim di As New DirectoryInfo("TempDir")

        ' Create the directory only if it does not already exist.
        If di.Exists = False Then
            di.Create()
        End If

        ' Create a subdirectory in the directory just created.
        Dim dis As DirectoryInfo = di.CreateSubdirectory("SubDir")

        ' Process that directory as required.
        ' ...

        ' Delete the subdirectory.
        dis.Delete(True)

        ' Delete the directory.
        di.Delete(True)
    End Sub
End Class

注釈

pathの一部が無効でない限り、pathで指定されたすべてのディレクトリが作成されます。 path パラメーターは、ファイル パスではなくディレクトリ パスを指定します。 サブディレクトリが既に存在する場合、このメソッドは何も行いません。

一般的な I/O タスクの一覧については、「 一般的な I/O タスク」を参照してください。

こちらもご覧ください

適用対象

CreateSubdirectory(String, DirectorySecurity)

指定したセキュリティを使用して、指定したパスにサブディレクトリまたはサブディレクトリを作成します。 指定したパスは、 DirectoryInfo クラスのこのインスタンスからの相対パスにすることができます。

public:
 System::IO::DirectoryInfo ^ CreateSubdirectory(System::String ^ path, System::Security::AccessControl::DirectorySecurity ^ directorySecurity);
public System.IO.DirectoryInfo CreateSubdirectory(string path, System.Security.AccessControl.DirectorySecurity directorySecurity);
member this.CreateSubdirectory : string * System.Security.AccessControl.DirectorySecurity -> System.IO.DirectoryInfo
Public Function CreateSubdirectory (path As String, directorySecurity As DirectorySecurity) As DirectoryInfo

パラメーター

path
String

指定したパス。 これは、別のディスク ボリュームまたは汎用名前付け規則 (UNC) 名にすることはできません。

directorySecurity
DirectorySecurity

適用するセキュリティ。

返品

pathで指定された最後のディレクトリ。

例外

path では、有効なファイル パスが指定されていないか、無効な DirectoryInfo 文字が含まれています。

pathnullです。

マップされていないドライブ上など、指定されたパスが無効です。

サブディレクトリを作成できません。

-または-

ファイルまたはディレクトリには、 pathで指定された名前が既に含まれています。

指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。

呼び出し元には、ディレクトリを作成するためのコード アクセス許可がありません。

-または-

呼び出し元には、返された DirectoryInfo オブジェクトによって記述されたディレクトリを読み取るコード アクセス許可がありません。 これは、 path パラメーターで既存のディレクトリが記述されている場合に発生する可能性があります。

path には、コロン文字 (ドライブ ラベル ("C:\") の一部ではない:)) が含まれています。

注釈

pathの一部が無効でない限り、pathで指定されたすべてのディレクトリが作成されます。 path パラメーターは、ファイル パスではなくディレクトリ パスを指定します。 サブディレクトリが既に存在する場合、このメソッドは何も行いません。

一般的な I/O タスクの一覧については、「 一般的な I/O タスク」を参照してください。

適用対象