DirectoryInfo.CreateSubdirectory メソッド

定義

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

オーバーロード

CreateSubdirectory(String)

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

CreateSubdirectory(String, DirectorySecurity)

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

CreateSubdirectory(String)

ソース:
DirectoryInfo.cs
ソース:
DirectoryInfo.cs
ソース:
DirectoryInfo.cs

指定したパスに 1 つ以上のサブディレクトリを作成します。 パスは、この 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 (Universal Naming Convention) 名は指定できません。

戻り値

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

例外

path は有効なファイル パスを指定していないか、または無効な DirectoryInfo 文字を含んでいます。

pathnullです。

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

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

- または -

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

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

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

- または -

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

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

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

using namespace System;
using namespace System::IO;
int main()
{
   
   // Create a reference to a directory.
   DirectoryInfo^ di = gcnew DirectoryInfo( "TempDir" );
   
   // Create the directory only if it does not already exist.
   if ( di->Exists == false )
      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 );
}
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 == false)
            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)

適用するセキュリティを指定して、指定したパスに 1 つ以上のサブディレクトリを作成します。 パスは、この 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 (Universal Naming Convention) 名は指定できません。

directorySecurity
DirectorySecurity

適用するセキュリティ。

戻り値

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

例外

path は有効なファイル パスを指定していないか、または無効な DirectoryInfo 文字を含んでいます。

pathnullです。

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

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

- または -

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

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

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

- または -

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

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

注釈

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

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

適用対象