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 указывает путь к каталогу, а не путь к файлу. Если подкаталог уже существует, этот метод ничего не делает.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• файлов и потоковой ввода-вывода
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл