DirectoryInfo.CreateSubdirectory Méthode

  • Référence

Définition

Espace de noms:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Crée un ou plusieurs sous-répertoires dans le chemin d'accès spécifié. Le chemin d'accès spécifié peut être relatif à cette instance de la classe DirectoryInfo.

Surcharges

CreateSubdirectory(String)

Crée un ou plusieurs sous-répertoires dans le chemin d'accès spécifié. Le chemin d'accès spécifié peut être relatif à cette instance de la classe DirectoryInfo.
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. Le chemin d'accès spécifié peut être relatif à cette instance de la classe DirectoryInfo.

CreateSubdirectory(String)

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

Crée un ou plusieurs sous-répertoires dans le chemin d'accès spécifié. Le chemin d'accès spécifié peut être relatif à cette instance de la classe 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

Paramètres

path
String

Chemin d'accès spécifié. Il ne peut pas s'agir d'un nom de volume de disque ou UNC différent.

Retours

DirectoryInfo

Dernier répertoire spécifié dans path.

Exceptions

ArgumentException

path ne spécifie pas un chemin de fichier valide ou contient des caractères DirectoryInfo non valides.

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.

IOException

Le sous-répertoire ne peut pas être créé.

- ou -

Un fichier a déjà le nom spécifié par path.

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

SecurityException

L’appelant ne dispose pas d’autorisation d’accès du code pour créer le répertoire.

- ou -

L’appelant ne dispose pas d’autorisation d’accès du code pour lire le répertoire décrit par l’objet DirectoryInfo retourné. Cela peut se produire quand le paramètre path décrit un répertoire existant.

NotSupportedException

path contient un signe deux-points (:) qui ne fait pas partie d’une étiquette de lecteur (« C:\ »).

Exemples

L’exemple suivant illustre la création d’un sous-répertoire. Dans cet exemple, les répertoires créés sont supprimés une fois créés. Par conséquent, pour tester cet exemple, commentez les lignes de suppression dans le 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);
    }
}

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

Remarques

Tous les répertoires spécifiés dans path sont créés, sauf si une partie de n’est path pas valide. Le path paramètre spécifie un chemin d’accès au répertoire, et non un chemin d’accès au fichier. Si le sous-répertoire existe déjà, cette méthode ne fait rien.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

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. Le chemin d'accès spécifié peut être relatif à cette instance de la classe 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

Paramètres

path
String

Chemin d'accès spécifié. Il ne peut pas s'agir d'un nom de volume de disque ou UNC différent.

directorySecurity
DirectorySecurity

Sécurité à appliquer.

Retours

DirectoryInfo

Dernier répertoire spécifié dans path.

Exceptions

ArgumentException

path ne spécifie pas un chemin de fichier valide ou contient des caractères DirectoryInfo non valides.

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.

IOException

Le sous-répertoire ne peut pas être créé.

- ou -

Un fichier ou un répertoire possède déjà le nom spécifié par path.

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

SecurityException

L’appelant ne dispose pas d’autorisation d’accès du code pour créer le répertoire.

- ou -

L’appelant ne dispose pas d’autorisation d’accès du code pour lire le répertoire décrit par l’objet DirectoryInfo retourné. Cela peut se produire quand le paramètre path décrit un répertoire existant.

NotSupportedException

path contient un signe deux-points (:) qui ne fait pas partie d’une étiquette de lecteur (« C:\ »).

Remarques

Tous les répertoires spécifiés dans path sont créés, sauf si une partie de n’est path pas valide. Le path paramètre spécifie un chemin d’accès au répertoire, et non un chemin d’accès au fichier. Si le sous-répertoire existe déjà, cette méthode ne fait rien.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

S’applique à