Directory.CreateDirectory Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Erstellt alle Verzeichnisse in einem angegebenen Pfad.

Überlädt

CreateDirectory(String)	Erstellt alle Verzeichnisse und Unterverzeichnisse im angegebenen Pfad, es sei denn, sie sind bereits vorhanden.
CreateDirectory(String, UnixFileMode)	Erstellt alle Verzeichnisse und Unterverzeichnisse im angegebenen Pfad mit den angegebenen Berechtigungen, sofern sie nicht bereits vorhanden sind.

CreateDirectory(String)

Quelle:

Directory.cs

Erstellt alle Verzeichnisse und Unterverzeichnisse im angegebenen Pfad, es sei denn, sie sind bereits vorhanden.

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

Parameter

path

String

Das zu erstellende Verzeichnis.

Gibt zurück

DirectoryInfo

Ein Objekt, das das Verzeichnis im angegebenen Pfad darstellt. Dieses Objekt wird unabhängig davon zurückgegeben, ob ein Verzeichnis unter dem angegebenen Pfad bereits vorhanden ist.

Ausnahmen

IOException

Das durch path angegebene Verzeichnis ist eine Datei.

- oder -

Der Netzwerkname ist nicht bekannt.

UnauthorizedAccessException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

ArgumentException

.NET Framework und .NET Core-Versionen älter als 2.1: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

- oder -

path ist ein Doppelpunkt (:) vorangestellt bzw. enthält nur einen Doppelpunkt.

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).

NotSupportedException

path enthält einen Doppelpunkt (:), der nicht Teil einer Laufwerksbezeichnung ("C:\") ist.

Beispiele

Im folgenden Beispiel wird das angegebene Verzeichnis erstellt und gelöscht:

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

Verwenden Sie einen der folgenden Aufrufe, um das Verzeichnis C:\Users\User1\Public\Html zu erstellen, wenn das aktuelle Verzeichnis C:\Users\User1 ist, um sicherzustellen, dass der umgekehrte Schrägstrich ordnungsgemäß interpretiert wird:

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

Hinweise

Alle in angegebenen path Verzeichnisse werden erstellt, es sei denn, sie sind bereits vorhanden oder ein Teil von path ist ungültig. Wenn das Verzeichnis bereits vorhanden ist, erstellt diese Methode kein neues Verzeichnis, gibt jedoch ein DirectoryInfo -Objekt für das vorhandene Verzeichnis zurück.

Der path Parameter gibt einen Verzeichnispfad und keinen Dateipfad an.

Nachfolgende Leerzeichen werden am Ende des path Parameters entfernt, bevor das Verzeichnis erstellt wird.

Sie können ein Verzeichnis auf einem Remotecomputer auf einer Freigabe erstellen, auf die Sie Schreibzugriff haben. UNC-Pfade werden unterstützt. Beispielsweise können Sie Folgendes für pathangeben: \\2009\Archives\December in Visual Basic und \\\\2009\\Archives\\December in C#.

Das Erstellen eines Verzeichnisses mit nur dem Doppelpunktzeichen (:) wird nicht unterstützt und bewirkt, dass ein NotSupportedException ausgelöst wird.

Verwenden Sie auf Unix-Systemen einen Schrägstrich (/) als Pfadtrennzeichen.

Weitere Informationen

• DirectoryInfo
• Datei- und Stream-E/A
• How to: Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei

CreateDirectory(String, UnixFileMode)

Quelle:

Directory.cs

Erstellt alle Verzeichnisse und Unterverzeichnisse im angegebenen Pfad mit den angegebenen Berechtigungen, sofern sie nicht bereits vorhanden sind.

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

Parameter

path

String

Das zu erstellende Verzeichnis.

unixCreateMode

UnixFileMode

Eine bitweise Kombination der Enumerationswerte, die den Unix-Dateimodus angibt, der zum Erstellen von Verzeichnissen verwendet wird.

Gibt zurück

DirectoryInfo

Ein Objekt, das das Verzeichnis im angegebenen Pfad darstellt. Dieses Objekt wird unabhängig davon zurückgegeben, ob ein Verzeichnis unter dem angegebenen Pfad bereits vorhanden ist.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

ArgumentException

path ist eine Zeichenfolge der Länge Null oder enthält ein oder mehrere ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

ArgumentNullException

path ist null.

ArgumentException

Der Dateimodus ist ungültig.

UnauthorizedAccessException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

PathTooLongException

Der angegebene Pfad überschreitet die für das System definierte maximale Länge.

IOException

path ist eine Datei.

DirectoryNotFoundException

Eine Komponente von path ist kein Verzeichnis.