DirectoryInfo.CreateSubdirectory 方法

参考

定义

命名空间:: System.IO

程序集:: mscorlib.dll, System.IO.FileSystem.dll

程序集:: System.IO.FileSystem.dll

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

在指定路径上创建一个或多个子目录。指定路径可以是相对于 DirectoryInfo 类的此实例的路径。

重载

CreateSubdirectory(String)	在指定路径上创建一个或多个子目录。指定路径可以是相对于 DirectoryInfo 类的此实例的路径。
CreateSubdirectory(String, DirectorySecurity)	使用指定的安全性在指定的路径上创建一个或多个子目录。指定路径可以是相对于 DirectoryInfo 类的此实例的路径。

CreateSubdirectory(String)

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Source:: 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 指定目录路径，而不是文件路径。如果子目录已存在，则此方法不执行任何操作。

有关常见 I/O 任务的列表，请参阅常见 I/O 任务。

另请参阅

适用于

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:\") 的一部分的冒号字符 (:)。

注解

有关常见 I/O 任务的列表，请参阅常见 I/O 任务。

适用于

DirectoryInfo.CreateSubdirectory 方法

定义

重载

CreateSubdirectory(String)

参数

返回

例外

示例

注解

另请参阅

适用于

CreateSubdirectory(String, DirectorySecurity)

参数

返回

例外

注解

适用于

反馈

其他资源