DirectoryInfo.CreateSubdirectory Método

  • Referencia

Definición

Espacio de nombres:
System.IO
Ensamblados:
mscorlib.dll, System.IO.FileSystem.dll
Ensamblado:
System.IO.FileSystem.dll
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

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

Sobrecargas

CreateSubdirectory(String)

Crea uno o varios subdirectorios en la ruta de acceso especificada. La ruta de acceso especificada puede ser relativa a esta instancia de la clase DirectoryInfo.
CreateSubdirectory(String, DirectorySecurity)

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

CreateSubdirectory(String)

Source:
DirectoryInfo.cs
Source:
DirectoryInfo.cs
Source:
DirectoryInfo.cs

Crea uno o varios subdirectorios en la ruta de acceso especificada. La ruta de acceso especificada puede ser relativa a esta instancia de la clase 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

Parámetros

path
String

La ruta de acceso especificada. No puede ser un volumen de disco diferente ni un nombre de convención de nomenclatura universal (Universal Naming Convention, UNC).

Devoluciones

DirectoryInfo

Último directorio especificado en path.

Excepciones

ArgumentException

path no especifica una ruta de acceso a archivo válida o no contiene DirectoryInfo caracteres.

ArgumentNullException

path es null.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, por ejemplo, está en una unidad no asignada.

IOException

No se puede crear el directorio.

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 llamador no tiene permiso de acceso a código para crear el directorio.

o bien

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

NotSupportedException

path contiene un carácter de dos puntos (:) que no forma parte de una etiqueta de unidad de disco ("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, convierta en comentario las líneas de eliminación en el código.

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

Comentarios

Se crean 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 de E/S comunes, consulte Tareas de E/S comunes.

Consulte también

Se aplica a

CreateSubdirectory(String, DirectorySecurity)

Crea uno o varios subdirectorios en la ruta de acceso especificada con la seguridad especificada. La ruta de acceso especificada puede ser relativa a esta instancia de la clase 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

Parámetros

path
String

La ruta de acceso especificada. No puede ser un volumen de disco diferente ni un nombre de convención de nomenclatura universal (Universal Naming Convention, 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 a archivo válida o no contiene DirectoryInfo caracteres.

ArgumentNullException

path es null.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, por ejemplo, está en una unidad no asignada.

IOException

No se puede crear el directorio.

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 llamador no tiene permiso de acceso a código para crear el directorio.

o bien

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

NotSupportedException

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

Comentarios

Se crean 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 de E/S comunes, consulte Tareas de E/S comunes.

Se aplica a