DirectoryInfo.CreateSubdirectory Méthode

Définition

Crée un ou plusieurs sous-répertoires dans le chemin d'accès spécifié.Creates a subdirectory or subdirectories on the specified path. Le chemin d'accès spécifié peut être relatif à cette instance de la classe DirectoryInfo.The specified path can be relative to this instance of the DirectoryInfo class.

Surcharges

CreateSubdirectory(String)

Crée un ou plusieurs sous-répertoires dans le chemin d'accès spécifié.Creates a subdirectory or subdirectories on the specified path. Le chemin d'accès spécifié peut être relatif à cette instance de la classe DirectoryInfo.The specified path can be relative to this instance of the DirectoryInfo class.

CreateSubdirectory(String, DirectorySecurity)

Crée un ou des sous-répertoires dans le chemin d'accès spécifié avec la sécurité spécifiée.Creates a subdirectory or subdirectories on the specified path with the specified security. Le chemin d'accès spécifié peut être relatif à cette instance de la classe DirectoryInfo.The specified path can be relative to this instance of the DirectoryInfo class.

CreateSubdirectory(String)

Crée un ou plusieurs sous-répertoires dans le chemin d'accès spécifié.Creates a subdirectory or subdirectories on the specified path. Le chemin d'accès spécifié peut être relatif à cette instance de la classe DirectoryInfo.The specified path can be relative to this instance of the DirectoryInfo class.

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

Paramètres

path
String

Chemin d'accès spécifié.The specified path. Il ne peut pas s'agir d'un nom de volume de disque ou UNC différent.This cannot be a different disk volume or Universal Naming Convention (UNC) name.

Retours

DirectoryInfo

Dernier répertoire spécifié dans path.The last directory specified in path.

Exceptions

path ne spécifie pas un chemin de fichier valide ou contient des caractères DirectoryInfo non valides.path does not specify a valid file path or contains invalid DirectoryInfo characters.

path a la valeur null.path is null.

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.The specified path is invalid, such as being on an unmapped drive.

Le sous-répertoire ne peut pas être créé.The subdirectory cannot be created.

- ou --or- Un fichier ou un répertoire possède déjà le nom spécifié par path.A file or directory already has the name specified by path.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

L’appelant ne dispose pas d’autorisation d’accès du code pour créer le répertoire.The caller does not have code access permission to create the directory.

- ou --or- L’appelant ne dispose pas d’autorisation d’accès du code pour lire le répertoire décrit par l’objet DirectoryInfo retourné.The caller does not have code access permission to read the directory described by the returned DirectoryInfo object. Cela peut se produire quand le paramètre path décrit un répertoire existant.This can occur when the path parameter describes an existing directory.

path contient un signe deux-points (:) qui ne fait pas partie d’une étiquette de lecteur (" C:\ ").path contains a colon character (:) that is not part of a drive label ("C:\").

Exemples

L’exemple suivant illustre la création d’un sous-répertoire.The following example demonstrates creating a subdirectory. Dans cet exemple, les répertoires créés sont supprimés une fois créés.In this example, the created directories are removed once created. Par conséquent, pour tester cet exemple, mettez en commentaire les lignes de suppression dans le code.Therefore, to test this sample, comment out the delete lines in the code.

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);
    }
}
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

Remarques

Tous les répertoires spécifiés dans path sont créés, sauf si une partie de path n’est pas valide.Any and all directories specified in path are created, unless some part of path is invalid. Le path paramètre spécifie un chemin d’accès de répertoire, et non un chemin d’accès de fichier.The path parameter specifies a directory path, not a file path. Si le sous-répertoire existe déjà, cette méthode n’a aucun effet.If the subdirectory already exists, this method does nothing.

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Voir aussi

S’applique à

CreateSubdirectory(String, DirectorySecurity)

Crée un ou des sous-répertoires dans le chemin d'accès spécifié avec la sécurité spécifiée.Creates a subdirectory or subdirectories on the specified path with the specified security. Le chemin d'accès spécifié peut être relatif à cette instance de la classe DirectoryInfo.The specified path can be relative to this instance of the DirectoryInfo class.

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

Paramètres

path
String

Chemin d'accès spécifié.The specified path. Il ne peut pas s'agir d'un nom de volume de disque ou UNC différent.This cannot be a different disk volume or Universal Naming Convention (UNC) name.

directorySecurity
DirectorySecurity

Sécurité à appliquer.The security to apply.

Retours

DirectoryInfo

Dernier répertoire spécifié dans path.The last directory specified in path.

Exceptions

path ne spécifie pas un chemin de fichier valide ou contient des caractères DirectoryInfo non valides.path does not specify a valid file path or contains invalid DirectoryInfo characters.

path a la valeur null.path is null.

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.The specified path is invalid, such as being on an unmapped drive.

Le sous-répertoire ne peut pas être créé.The subdirectory cannot be created.

- ou --or- Un fichier ou un répertoire possède déjà le nom spécifié par path.A file or directory already has the name specified by path.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

L’appelant ne dispose pas d’autorisation d’accès du code pour créer le répertoire.The caller does not have code access permission to create the directory.

- ou --or- L’appelant ne dispose pas d’autorisation d’accès du code pour lire le répertoire décrit par l’objet DirectoryInfo retourné.The caller does not have code access permission to read the directory described by the returned DirectoryInfo object. Cela peut se produire quand le paramètre path décrit un répertoire existant.This can occur when the path parameter describes an existing directory.

path contient un signe deux-points (:) qui ne fait pas partie d’une étiquette de lecteur (" C:\ ").path contains a colon character (:) that is not part of a drive label ("C:\").

Remarques

Tous les répertoires spécifiés dans path sont créés, sauf si une partie de path n’est pas valide.Any and all directories specified in path are created, unless some part of path is invalid. Le path paramètre spécifie un chemin d’accès de répertoire, et non un chemin d’accès de fichier.The path parameter specifies a directory path, not a file path. Si le sous-répertoire existe déjà, cette méthode n’a aucun effet.If the subdirectory already exists, this method does nothing.

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

S’applique à