DirectoryInfo.CreateSubdirectory Метод

Определение

Создает подкаталог или вложенные каталоги по указанному пути. Указанный путь может быть относительным к этому экземпляру класса DirectoryInfo.

Перегрузки

CreateSubdirectory(String)

Создает подкаталог или вложенные каталоги по указанному пути. Указанный путь может быть относительным к этому экземпляру класса DirectoryInfo.

CreateSubdirectory(String, DirectorySecurity)

Создает подкаталог или подкаталоги по указанному пути с заданным безопасностью. Указанный путь может быть относительным к этому экземпляру класса DirectoryInfo.

CreateSubdirectory(String)

Исходный код:
DirectoryInfo.cs
Исходный код:
DirectoryInfo.cs
Исходный код:
DirectoryInfo.cs

Создает подкаталог или вложенные каталоги по указанному пути. Указанный путь может быть относительным к этому экземпляру класса DirectoryInfo.

public System.IO.DirectoryInfo CreateSubdirectory (string path);

Параметры

path
String

Указанный путь. Это не может быть другое имя тома диска или универсального соглашения об именовании (UNC).

Возвращаемое значение

Последний каталог, указанный в path.

Исключения

path не указывает допустимый путь к файлу или содержит недопустимые DirectoryInfo символы.

Указанный путь недопустим, например на несопоставленном диске.

Не удается создать подкаталог.

-или-

Файл уже имеет имя, указанное 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 == 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);
    }
}

Комментарии

Все каталоги, указанные в path, создаются, если часть path не является недопустимой. Параметр path указывает путь к каталогу, а не путь к файлу. Если подкаталог уже существует, этот метод ничего не делает.

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

CreateSubdirectory(String, DirectorySecurity)

Создает подкаталог или подкаталоги по указанному пути с заданным безопасностью. Указанный путь может быть относительным к этому экземпляру класса DirectoryInfo.

public System.IO.DirectoryInfo CreateSubdirectory (string path, System.Security.AccessControl.DirectorySecurity directorySecurity);

Параметры

path
String

Указанный путь. Это не может быть другое имя тома диска или универсального соглашения об именовании (UNC).

directorySecurity
DirectorySecurity

Применяется безопасность.

Возвращаемое значение

Последний каталог, указанный в path.

Исключения

path не указывает допустимый путь к файлу или содержит недопустимые DirectoryInfo символы.

Указанный путь недопустим, например на несопоставленном диске.

Не удается создать подкаталог.

-или-

Файл или каталог уже имеет имя, указанное path.

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

Вызывающий объект не имеет разрешения на доступ к коду для создания каталога.

-или-

Вызывающий объект не имеет разрешения на доступ к коду для чтения каталога, описанного возвращенным объектом DirectoryInfo. Это может произойти, когда параметр path описывает существующий каталог.

path содержит символ двоеточия (:), который не входит в метку диска ("C:\").

Комментарии

Все каталоги, указанные в path, создаются, если часть path не является недопустимой. Параметр path указывает путь к каталогу, а не путь к файлу. Если подкаталог уже существует, этот метод ничего не делает.

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

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1