DirectoryInfo.CreateSubdirectory Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
Último directorio especificado en path
.
Excepciones
path
no especifica una ruta de acceso a archivo válida o no contiene DirectoryInfo
caracteres.
path
es null
.
La ruta de acceso especificada no es válida, por ejemplo, está en una unidad no asignada.
No se puede crear el directorio.
o bien
Un archivo ya tiene el nombre especificado por path
.
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
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.
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
Último directorio especificado en path
.
Excepciones
path
no especifica una ruta de acceso a archivo válida o no contiene DirectoryInfo
caracteres.
path
es null
.
La ruta de acceso especificada no es válida, por ejemplo, está en una unidad no asignada.
No se puede crear el directorio.
o bien
Un archivo o directorio ya tiene el nombre especificado por path
.
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
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.
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.