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

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

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

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