DirectoryInfo.CreateSubdirectory Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

mscorlib.dll

Crea un subdirectorio o subdirectorios en la ruta de acceso especificada. La ruta de acceso especificada puede ser relativa a esta instancia de la DirectoryInfo clase .

Sobrecargas

Nombre	Description
CreateSubdirectory(String)	Crea un subdirectorio o subdirectorios en la ruta de acceso especificada. La ruta de acceso especificada puede ser relativa a esta instancia de la DirectoryInfo clase .
CreateSubdirectory(String, DirectorySecurity)	Crea un subdirectorio o subdirectorios en la ruta de acceso especificada con la seguridad especificada. La ruta de acceso especificada puede ser relativa a esta instancia de la DirectoryInfo clase .

CreateSubdirectory(String)

Crea un subdirectorio o subdirectorios en la ruta de acceso especificada. La ruta de acceso especificada puede ser relativa a esta instancia de la DirectoryInfo clase .

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

Parámetros

path

String

Ruta de acceso especificada. No puede ser un volumen de disco diferente o un nombre de convención de nomenclatura universal (UNC).

Devoluciones

DirectoryInfo

Último directorio especificado en path.

Excepciones

ArgumentException

path no especifica una ruta de acceso de archivo válida ni contiene caracteres no válidos DirectoryInfo .

ArgumentNullException

path es null.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, como estar en una unidad no asignada.

IOException

No se puede crear el subdirectorio.

O bien

Un archivo ya tiene el nombre especificado por path.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

SecurityException

El autor de la llamada no tiene permiso de acceso al código para crear el directorio.

O bien

El autor de la llamada no tiene permiso de acceso al código para leer el directorio descrito por el objeto devuelto DirectoryInfo . Esto puede ocurrir cuando el path parámetro describe un directorio existente.

NotSupportedException

path contiene un carácter de dos puntos (:) que no forma parte de una etiqueta de unidad ("C:\").

Ejemplos

En el ejemplo siguiente se muestra cómo crear un subdirectorio. En este ejemplo, los directorios creados se quitan una vez creados. Por lo tanto, para probar este ejemplo, comente las líneas de eliminación en el código.

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

Comentarios

Se crean todos los directorios y todos los directorios especificados en path , a menos que alguna parte de path no sea válida. El path parámetro especifica una ruta de acceso de directorio, no una ruta de acceso de archivo. Si el subdirectorio ya existe, este método no hace nada.

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

• E/S de archivos y secuencias
• Cómo: Leer texto de un archivo
• Cómo: Escribir texto en un archivo

CreateSubdirectory(String, DirectorySecurity)

Crea un subdirectorio o subdirectorios en la ruta de acceso especificada con la seguridad especificada. La ruta de acceso especificada puede ser relativa a esta instancia de la DirectoryInfo clase .

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

Parámetros

path

String

Ruta de acceso especificada. No puede ser un volumen de disco diferente o un nombre de convención de nomenclatura universal (UNC).

directorySecurity

DirectorySecurity

Seguridad que se va a aplicar.

Devoluciones

DirectoryInfo

Último directorio especificado en path.

Excepciones

ArgumentException

path no especifica una ruta de acceso de archivo válida ni contiene caracteres no válidos DirectoryInfo .

ArgumentNullException

path es null.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, como estar en una unidad no asignada.

IOException

No se puede crear el subdirectorio.

O bien

Un archivo o directorio ya tiene el nombre especificado por path.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

SecurityException

El autor de la llamada no tiene permiso de acceso al código para crear el directorio.

O bien

El autor de la llamada no tiene permiso de acceso al código para leer el directorio descrito por el objeto devuelto DirectoryInfo . Esto puede ocurrir cuando el path parámetro describe un directorio existente.

NotSupportedException

path contiene un carácter de dos puntos (:) que no forma parte de una etiqueta de unidad ("C:\").

Comentarios

Se crean todos los directorios y todos los directorios especificados en path , a menos que alguna parte de path no sea válida. El path parámetro especifica una ruta de acceso de directorio, no una ruta de acceso de archivo. Si el subdirectorio ya existe, este método no hace nada.

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.