Share via

DirectoryInfo.Create Metoda

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
mscorlib.dll, System.IO.FileSystem.dll
Sestavení:
System.IO.FileSystem.dll
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Vytvoří adresář.

Přetížení

Create()

Vytvoří adresář.
Create(DirectorySecurity)

Vytvoří adresář pomocí objektu DirectorySecurity .

Create()

Zdroj:
DirectoryInfo.cs
Zdroj:
DirectoryInfo.cs
Zdroj:
DirectoryInfo.cs

Vytvoří adresář.

public:
 void Create();
public void Create ();
member this.Create : unit -> unit
Public Sub Create ()

Výjimky

IOException

Adresář nelze vytvořit.

Příklady

Následující příklad zkontroluje, zda zadaný adresář existuje, vytvoří adresář, pokud neexistuje, a odstraní adresář.

using namespace System;
using namespace System::IO;
int main()
{
   
   // Specify the directories you want to manipulate.
   DirectoryInfo^ di = gcnew DirectoryInfo( "c:\\MyDir" );
   try
   {
      
      // Determine whether the directory exists.
      if ( di->Exists )
      {
         
         // Indicate that it already exists.
         Console::WriteLine( "That path exists already." );
         return 0;
      }
      
      // Try to create the directory.
      di->Create();
      Console::WriteLine( "The directory was created successfully." );
      
      // 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 directories you want to manipulate.
        DirectoryInfo di = new DirectoryInfo(@"c:\MyDir");

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

            // Try to create the directory.
            di.Create();
            Console.WriteLine("The directory was created successfully.");

            // 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 directories you want to manipulate.
let di = DirectoryInfo @"c:\MyDir"

try
    // Determine whether the directory exists.
    if di.Exists then
        // Indicate that it already exists.
        printfn "That path exists already."
    else
        // Try to create the directory.
        di.Create()
        printfn "The directory was created successfully."

        // 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 directories you want to manipulate.
        Dim di As DirectoryInfo = New DirectoryInfo("c:\MyDir")
        Try
            ' Determine whether the directory exists.
            If di.Exists Then
                ' Indicate that it already exists.
                Console.WriteLine("That path exists already.")
                Return
            End If

            ' Try to create the directory.
            di.Create()
            Console.WriteLine("The directory was created successfully.")

            '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

Poznámky

Vytvoří se všechny a všechny adresáře zadané v path adresáři, pokud některá část není path neplatná. Parametr path určuje cestu k adresáři, nikoli cestu k souboru. Pokud adresář již existuje, tato metoda neprovede nic. Pokud adresář před voláním této metody neexistoval, budou v případě úspěšného vytvoření vyprázdněné všechny informace o atributech uložených v mezipaměti adresáře.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro

Create(DirectorySecurity)

Vytvoří adresář pomocí objektu DirectorySecurity .

public:
 void Create(System::Security::AccessControl::DirectorySecurity ^ directorySecurity);
public void Create (System.Security.AccessControl.DirectorySecurity directorySecurity);
member this.Create : System.Security.AccessControl.DirectorySecurity -> unit
Public Sub Create (directorySecurity As DirectorySecurity)

Parametry

directorySecurity
DirectorySecurity

Řízení přístupu, které se má použít pro adresář.

Výjimky

UnauthorizedAccessException

Volající nemá požadované oprávnění.

ArgumentException

.NET Framework a .NET Core verze starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Na neplatné znaky se můžete dotazovat pomocí metody .GetInvalidPathChars()

ArgumentNullException

path je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

DirectoryNotFoundException

Zadaná cesta je neplatná, například na nenamapované jednotce.

NotSupportedException

Došlo k pokusu o vytvoření adresáře pouze s dvojtečkami (:) znakem.

Příklady

Následující příklad kódu vytvoří nový adresář uvnitř dočasné složky uživatele se zadanými atributy zabezpečení adresáře:

using System.IO;
using System.Security.AccessControl;
using System.Security.Principal;
namespace ConsoleApp
{
    class Program
    {
        static void Main()
        {
            DirectorySecurity security = new DirectorySecurity();
            SecurityIdentifier identity = new SecurityIdentifier(WellKnownSidType.BuiltinUsersSid, null);
            FileSystemAccessRule accessRule = new FileSystemAccessRule(identity, FileSystemRights.FullControl, AccessControlType.Allow);
            security.AddAccessRule(accessRule);
            string path = Path.Combine(Path.GetTempPath(), "directoryToCreate");
            DirectoryInfo dirInfo = new DirectoryInfo(path);
            dirInfo.Create(security);
        }
    }
}

Poznámky

Pomocí tohoto přetížení metody můžete vytvořit adresář s řízením přístupu, aby před použitím zabezpečení nebylo možné k adresáři získat přístup.

Pokud adresář již existuje, tato metoda neprovede nic.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Důležité

Tato metoda byla přenesena do .NET Core 3.1 jako rozšiřující metoda FileSystemAclExtensions třídy jako součást System.Security.AccessControl sestavení: Create(DirectoryInfo, DirectorySecurity).

Platí pro