Поделиться через


DirectoryInfo.CreateSubdirectory Метод

Определение

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

Перегрузки

CreateSubdirectory(String)

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

CreateSubdirectory(String, DirectorySecurity)

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

CreateSubdirectory(String)

Исходный код:
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.

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

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

Исключения

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

path имеет значение null.

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

Подкаталог не может быть создан.

-или-

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

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

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

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

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

Параметры безопасности, которые необходимо применить.

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

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

Исключения

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

path имеет значение null.

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

Подкаталог не может быть создан.

-или-

Имя файла или каталога совпадает с именем, указанным в path.

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

У вызывающего оператора отсутствует разрешение на доступ к коду для создания каталога.

-или-

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

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

Комментарии

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

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

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