Directory.CreateDirectory Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Crée tous les répertoires dans un chemin d'accès spécifié.

Surcharges

CreateDirectory(String)	Crée tous les répertoires et sous-répertoires dans le chemin d'accès spécifié, sauf s'ils existent déjà.
CreateDirectory(String, UnixFileMode)	Crée tous les répertoires et sous-répertoires dans le chemin d’accès spécifié avec les autorisations spécifiées, sauf s’ils existent déjà.

CreateDirectory(String)

Source:

Directory.cs

Crée tous les répertoires et sous-répertoires dans le chemin d'accès spécifié, sauf s'ils existent déjà.

public:
 static System::IO::DirectoryInfo ^ CreateDirectory(System::String ^ path);

public static System.IO.DirectoryInfo CreateDirectory (string path);

static member CreateDirectory : string -> System.IO.DirectoryInfo

Public Shared Function CreateDirectory (path As String) As DirectoryInfo

Paramètres

path

String

Répertoire à créer.

Retours

DirectoryInfo

Objet qui représente le répertoire dans le chemin d'accès spécifié. Cet objet est retourné, qu'un répertoire existe déjà ou non dans le chemin d'accès spécifié.

Exceptions

IOException

Le répertoire spécifié par path est un fichier.

- ou -

Le nom de réseau est inconnu.

UnauthorizedAccessException

L'appelant n'a pas l'autorisation requise.

ArgumentException

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

- ou -

Le préfixe ou le contenu de path est uniquement un signe deux-points (:).

ArgumentNullException

path a la valeur null.

PathTooLongException

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

DirectoryNotFoundException

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

NotSupportedException

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

Exemples

L’exemple suivant crée et supprime le répertoire spécifié :

using namespace System;
using namespace System::IO;
int main()
{
   
   // Specify the directory you want to manipulate.
   String^ path = "c:\\MyDir";
   try
   {
      
      // Determine whether the directory exists.
      if ( Directory::Exists( path ) )
      {
         Console::WriteLine( "That path exists already." );
         return 0;
      }
      
      // Try to create the directory.
      DirectoryInfo^ di = Directory::CreateDirectory( path );
      Console::WriteLine( "The directory was created successfully at {0}.", Directory::GetCreationTime( path ) );
      
      // Delete the directory.
      di->Delete();
      Console::WriteLine( "The directory was deleted successfully." );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }

}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        // Specify the directory you want to manipulate.
        string path = @"c:\MyDir";

        try
        {
            // Determine whether the directory exists.
            if (Directory.Exists(path))
            {
                Console.WriteLine("That path exists already.");
                return;
            }

            // Try to create the directory.
            DirectoryInfo di = Directory.CreateDirectory(path);
            Console.WriteLine("The directory was created successfully at {0}.", Directory.GetCreationTime(path));

            // Delete the directory.
            di.Delete();
            Console.WriteLine("The directory was deleted successfully.");
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
        finally {}
    }
}

open System.IO

// Specify the directory you want to manipulate.
let path = @"c:\MyDir"

try
    // Determine whether the directory exists.
    if Directory.Exists path then
        printfn "That path exists already."
    else
        // Try to create the directory.
        let di = Directory.CreateDirectory path
        printfn $"The directory was created successfully at {Directory.GetCreationTime path}."

        // Delete the directory.
        di.Delete()
        printfn "The directory was deleted successfully."
with e ->
    printfn $"The process failed: {e}"

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        ' Specify the directory you want to manipulate.
        Dim path As String = "c:\MyDir"

        Try
            ' Determine whether the directory exists.
            If Directory.Exists(path) Then
                Console.WriteLine("That path exists already.")
                Return
            End If

            ' Try to create the directory.
            Dim di As DirectoryInfo = Directory.CreateDirectory(path)
            Console.WriteLine("The directory was created successfully at {0}.", Directory.GetCreationTime(path))

            ' Delete the directory.
            di.Delete()
            Console.WriteLine("The directory was deleted successfully.")

        Catch e As Exception
            Console.WriteLine("The process failed: {0}.", e.ToString())
        End Try
    End Sub
End Class

Pour créer le répertoire C :\Users\User1\Public\Html lorsque le répertoire actuel est C :\Users\User1, utilisez l’un des appels suivants pour vous assurer que la barre oblique inverse est interprétée correctement :

Directory.CreateDirectory("Public\Html")
Directory.CreateDirectory("\Users\User1\Public\Html")
Directory.CreateDirectory("c:\Users\User1\Public\Html")

Directory.CreateDirectory("Public\\Html");
Directory.CreateDirectory("\\Users\\User1\\Public\\Html");
Directory.CreateDirectory("c:\\Users\\User1\\Public\\Html");

Directory::CreateDirectory("Public\\Html");
Directory::CreateDirectory("\\Users\\User1\\Public\\Html");
Directory::CreateDirectory("c:\\Users\\User1\\Public\\Html");

Remarques

Tous les répertoires spécifiés dans path sont créés, sauf s’ils existent déjà ou si une partie de n’est path pas valide. Si le répertoire existe déjà, cette méthode ne crée pas de répertoire, mais elle retourne un DirectoryInfo objet pour le répertoire existant.

Le path paramètre spécifie un chemin d’accès au répertoire, pas un chemin d’accès de fichier.

Les espaces de fin sont supprimés de la fin du path paramètre avant de créer le répertoire.

Vous pouvez créer un répertoire sur un ordinateur distant, sur un partage auquel vous avez accès en écriture. Les chemins UNC sont pris en charge ; par exemple, vous pouvez spécifier ce qui suit pour path: \\2009\Archives\December en Visual Basic et \\\\2009\\Archives\\December en C#.

La création d’un répertoire avec uniquement le caractère deux-points (:) n’est pas pris en charge et entraîne la levée d’un NotSupportedException .

Sur les systèmes Unix, utilisez une barre oblique (/) comme séparateur de chemin.

Voir aussi

• DirectoryInfo
• Fichier et flux de données E/S
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier

CreateDirectory(String, UnixFileMode)

Source:

Directory.cs

Crée tous les répertoires et sous-répertoires dans le chemin d’accès spécifié avec les autorisations spécifiées, sauf s’ils existent déjà.

public:
 static System::IO::DirectoryInfo ^ CreateDirectory(System::String ^ path, System::IO::UnixFileMode unixCreateMode);

[System.Runtime.Versioning.UnsupportedOSPlatform("windows")]
public static System.IO.DirectoryInfo CreateDirectory (string path, System.IO.UnixFileMode unixCreateMode);

[<System.Runtime.Versioning.UnsupportedOSPlatform("windows")>]
static member CreateDirectory : string * System.IO.UnixFileMode -> System.IO.DirectoryInfo

Public Shared Function CreateDirectory (path As String, unixCreateMode As UnixFileMode) As DirectoryInfo

Paramètres

path

String

Répertoire à créer.

unixCreateMode

UnixFileMode

Combinaison au niveau du bit des valeurs d’énumération qui spécifie le mode de fichier Unix utilisé pour créer des répertoires.

Retours

DirectoryInfo

Objet qui représente le répertoire dans le chemin d'accès spécifié. Cet objet est retourné, qu'un répertoire existe déjà ou non dans le chemin d'accès spécifié.

Attributs

UnsupportedOSPlatformAttribute

Exceptions

ArgumentException

path est une chaîne de longueur nulle ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

ArgumentNullException

path a la valeur null.

ArgumentException

Le mode fichier n’est pas valide.

UnauthorizedAccessException

L'appelant n'a pas l'autorisation requise.

PathTooLongException

Le chemin spécifié dépasse la longueur maximale définie par le système.

IOException

path est un fichier.

DirectoryNotFoundException

Un composant de n’est path pas un répertoire.