DirectoryInfo.CreateSubdirectory Méthode

Définition

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

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

Surcharges

Nom Description
CreateSubdirectory(String)

Crée un sous-répertoire ou des sous-répertoires sur le chemin d’accès spécifié. Le chemin d’accès spécifié peut être relatif à cette instance de la DirectoryInfo classe.
CreateSubdirectory(String, DirectorySecurity)

Crée un sous-répertoire ou des sous-répertoires sur le chemin spécifié avec la sécurité spécifiée. Le chemin d’accès spécifié peut être relatif à cette instance de la DirectoryInfo classe.

CreateSubdirectory(String)

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

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 autre volume de disque ou d’un nom UNC (Universal Naming Convention).

Retours

DirectoryInfo

Dernier répertoire spécifié dans path.

Exceptions

ArgumentException

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

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

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

IOException

Impossible de créer le sous-répertoire.

-ou-

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

PathTooLongException

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

SecurityException

L’appelant n’a pas l’autorisation d’accès au code pour créer le répertoire.

-ou-

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

NotSupportedException

path contient un caractère 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 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

Remarques

Tous les répertoires spécifiés dans path sont créés, sauf si une partie 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 d’E/S courantes.

Voir aussi

S’applique à

CreateSubdirectory(String, DirectorySecurity)

Crée un sous-répertoire ou des sous-répertoires sur le chemin spécifié avec la sécurité spécifiée. Le chemin d’accès spécifié peut être relatif à cette instance de la DirectoryInfo classe.

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 autre volume de disque ou d’un nom UNC (Universal Naming Convention).

directorySecurity
DirectorySecurity

Sécurité à appliquer.

Retours

DirectoryInfo

Dernier répertoire spécifié dans path.

Exceptions

ArgumentException

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

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

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

IOException

Impossible de créer le sous-répertoire.

-ou-

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

PathTooLongException

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

SecurityException

L’appelant n’a pas l’autorisation d’accès au code pour créer le répertoire.

-ou-

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

NotSupportedException

path contient un caractère 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 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 d’E/S courantes.

S’applique à