DirectoryInfo.CreateSubdirectory Метод

Определение

Пространство имен:
System.IO
Сборки:
mscorlib.dll, System.IO.FileSystem.dll
Сборки:
netstandard.dll, System.Runtime.dll
Сборки:
netstandard.dll, System.IO.FileSystem.dll
Сборки:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Сборка:
System.IO.FileSystem.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

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

Перегрузки

Имя Описание
CreateSubdirectory(String)

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

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

CreateSubdirectory(String)

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

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

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

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

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

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

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

DirectoryInfo

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

Исключения

ArgumentException

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

ArgumentNullException

path равно null.

DirectoryNotFoundException

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

IOException

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

–или–

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

PathTooLongException

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

SecurityException

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

–или–

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

NotSupportedException

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

Комментарии

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

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

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