DirectoryInfo.CreateSubdirectory メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

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

オーバーロード

CreateSubdirectory(String)

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

CreateSubdirectory(String)

ソース:

DirectoryInfo.cs

指定したパスにサブディレクトリまたはサブディレクトリを作成します。 指定したパスは、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) 名にすることはできません。

戻り値

DirectoryInfo

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

例外

ArgumentException

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

ArgumentNullException

path は nullです。

DirectoryNotFoundException

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

IOException

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

-又は-

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

PathTooLongException

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

SecurityException

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

-又は-

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

NotSupportedException

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 タスクの」を参照してください。

こちらもご覧ください

• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む