DirectoryInfo.CreateSubdirectory 方法

定义

命名空间:

System.IO

程序集:

netstandard.dll, System.Runtime.dll

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

重载

名称	说明
CreateSubdirectory(String)	在指定路径上创建子目录或子目录。 指定的路径可以相对于类的 DirectoryInfo 此实例。

CreateSubdirectory(String)

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

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

另请参阅

• 文件和流输入/输出
• 如何：从文件读取文本
• 如何：将文本写入文件