DirectoryInfo.CreateSubdirectory Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает подкаталог или вложенные каталоги по указанному пути. Указанный путь может быть относительным к этому экземпляру класса DirectoryInfo.
CreateSubdirectory(String) |
Создает подкаталог или вложенные каталоги по указанному пути. Указанный путь может быть относительным к этому экземпляру класса DirectoryInfo. |
CreateSubdirectory(String, DirectorySecurity) |
Создает подкаталог или подкаталоги по указанному пути с заданным безопасностью. Указанный путь может быть относительным к этому экземпляру класса DirectoryInfo. |
- Исходный код:
- 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
.
Указанный путь недопустим, например на несопоставленном диске.
Указанный путь, имя файла или оба превышают определенную системой максимальную длину.
Вызывающий объект не имеет разрешения на доступ к коду для создания каталога.
-или-
Вызывающий объект не имеет разрешения на доступ к коду для чтения каталога, описанного возвращенным объектом 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
указывает путь к каталогу, а не путь к файлу. Если подкаталог уже существует, этот метод ничего не делает.
Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.
См. также раздел
- файлов и потоковой ввода-вывода
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
.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 |
Создает подкаталог или подкаталоги по указанному пути с заданным безопасностью. Указанный путь может быть относительным к этому экземпляру класса 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
.
Указанный путь недопустим, например на несопоставленном диске.
Указанный путь, имя файла или оба превышают определенную системой максимальную длину.
Вызывающий объект не имеет разрешения на доступ к коду для создания каталога.
-или-
Вызывающий объект не имеет разрешения на доступ к коду для чтения каталога, описанного возвращенным объектом 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 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: