FileSystemAclExtensions.Create Metodo

Definizione

Overload

Create(DirectoryInfo, DirectorySecurity)

Crea una nuova directory, verificando che venga creata con la sicurezza della directory specificata.Creates a new directory, ensuring it is created with the specified directory security. Se la directory esiste già non viene eseguita nessuna operazione.If the directory already exists, nothing is done.

Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

Crea un nuovo flusso di file, verificando che venga creato con le proprietà e le impostazioni di sicurezza specificate.Creates a new file stream, ensuring it is created with the specified properties and security settings.

Create(DirectoryInfo, DirectorySecurity)

Crea una nuova directory, verificando che venga creata con la sicurezza della directory specificata.Creates a new directory, ensuring it is created with the specified directory security. Se la directory esiste già non viene eseguita nessuna operazione.If the directory already exists, nothing is done.

public:
[System::Runtime::CompilerServices::Extension]
 static void Create(System::IO::DirectoryInfo ^ directoryInfo, System::Security::AccessControl::DirectorySecurity ^ directorySecurity);
public static void Create (this System.IO.DirectoryInfo directoryInfo, System.Security.AccessControl.DirectorySecurity directorySecurity);
static member Create : System.IO.DirectoryInfo * System.Security.AccessControl.DirectorySecurity -> unit
<Extension()>
Public Sub Create (directoryInfo As DirectoryInfo, directorySecurity As DirectorySecurity)

Parametri

directoryInfo
DirectoryInfo

Una directory che non esiste ancora e che verrà creata dal metodo.A directory that does not exist yet that will be created by the method.

directorySecurity
DirectorySecurity

Controllo di accesso e sicurezza di controllo della directory.The access control and audit security for the directory.

Eccezioni

directoryInfo o directorySecurity è null.directoryInfo or directorySecurity is null.

Non è possibile trovare una parte del percorso.Could not find a part of the path.

Accesso al percorso negato.Access to the path is denied.

Esempio

Nell'esempio di codice seguente viene creata una nuova directory all'interno della cartella temporanea dell'utente con gli attributi di sicurezza della directory specificati:The following code example creates a new directory inside the user's temporary folder with the specified directory security attributes:

using System.IO;
using System.Runtime.Versioning;
using System.Security.AccessControl;
using System.Security.Principal;

namespace MyNamespace
{
    public class MyClassCS
    {
        // Attribute to address CA1416 warning:
        // System.IO.FileSystem.AccessControl APIs are  only available on Windows
        [SupportedOSPlatform("windows")]
        static void Main()
        {
            // Create the file security object

            SecurityIdentifier identity = new SecurityIdentifier(
                WellKnownSidType.BuiltinUsersSid, // This maps to "Everyone" user group in Windows
                null); // null is OK for this particular user group. For others, a non-empty value might be required
            FileSystemAccessRule accessRule = new FileSystemAccessRule(identity, FileSystemRights.FullControl, AccessControlType.Allow);

            DirectorySecurity expectedSecurity = new DirectorySecurity();
            expectedSecurity.AddAccessRule(accessRule);

            // Make sure the directory does not exist, then create it

            string dirPath = Path.Combine(Path.GetTempPath(), "directoryToCreate");
            DirectoryInfo dirInfo = new DirectoryInfo(dirPath);
            if (dirInfo.Exists)
            {
                dirInfo.Delete(recursive: true);
            }

            dirInfo.Create(expectedSecurity);
        }
    }
}

Commenti

Questo metodo di estensione è stato aggiunto a .NET Core per fornire la funzionalità fornita dal metodo di .NET Framework DirectoryInfo. Create (DirectorySecurity) .This extension method was added to .NET Core to bring the functionality that was provided by the DirectoryInfo.Create(DirectorySecurity) .NET Framework method.

Si applica a

Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

Crea un nuovo flusso di file, verificando che venga creato con le proprietà e le impostazioni di sicurezza specificate.Creates a new file stream, ensuring it is created with the specified properties and security settings.

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::FileStream ^ Create(System::IO::FileInfo ^ fileInfo, System::IO::FileMode mode, System::Security::AccessControl::FileSystemRights rights, System::IO::FileShare share, int bufferSize, System::IO::FileOptions options, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public static System.IO.FileStream Create (this System.IO.FileInfo fileInfo, System.IO.FileMode mode, System.Security.AccessControl.FileSystemRights rights, System.IO.FileShare share, int bufferSize, System.IO.FileOptions options, System.Security.AccessControl.FileSecurity fileSecurity);
static member Create : System.IO.FileInfo * System.IO.FileMode * System.Security.AccessControl.FileSystemRights * System.IO.FileShare * int * System.IO.FileOptions * System.Security.AccessControl.FileSecurity -> System.IO.FileStream
<Extension()>
Public Function Create (fileInfo As FileInfo, mode As FileMode, rights As FileSystemRights, share As FileShare, bufferSize As Integer, options As FileOptions, fileSecurity As FileSecurity) As FileStream

Parametri

fileInfo
FileInfo

Un file che non esiste ancora e che verrà creato dal metodo.A file that does not exist yet that will be created by the method.

mode
FileMode

Uno dei valori di enumerazione che specifica la modalità con cui il sistema operativo apre un file.One of the enumeration values that specifies how the operating system should open a file.

rights
FileSystemRights

Uno dei valori di enumerazione che determina i diritti di accesso da usare quando si creano regole di accesso e di controllo.One of the enumeration values that defines the access rights to use when creating access and audit rules.

share
FileShare

Uno dei valori di enumerazione per il controllo del tipo di accesso allo stesso file disponibile per altri oggetti flusso di file.One of the enumeration values for controlling the kind of access other file stream objects can have to the same file.

bufferSize
Int32

Numero di byte memorizzati nel buffer per letture e scritture nel file.The number of bytes buffered for reads and writes to the file.

options
FileOptions

Uno dei valori di enumerazione che descrive come creare o sovrascrivere il file.One of the enumeration values that describes how to create or overwrite the file.

fileSecurity
FileSecurity

Oggetto che determina il controllo di accesso e la sicurezza di controllo per il file.An object that determines the access control and audit security for the file.

Restituisce

FileStream

Flusso di file per il file appena creato.A file stream for the newly created file.

Eccezioni

La combinazione di rights e mode non è valida.The rights and mode combination is invalid.

fileInfo o fileSecurity è null.fileInfo or fileSecurity is null.

mode o share non rientrano nel rispettivo intervallo enum valido.mode or share are out of their legal enum range.

-oppure--or-

bufferSize non è un numero positivo.bufferSize is not a positive number.

Non è possibile trovare una parte del percorso.Could not find a part of the path.

Si è verificato un errore di I/O.An I/O error occurred.

Accesso al percorso negato.Access to the path is denied.

Esempio

Nell'esempio di codice seguente viene creato un nuovo file di testo nella cartella temporanea dell'utente, specificando in modo esplicito tutti gli attributi di sicurezza:The following code example creates a new text file inside the user's temporary folder, explicitly specifying all security attributes:

using System;
using System.IO;
using System.Runtime.Versioning;
using System.Security.AccessControl;
using System.Security.Principal;
using System.Text;

namespace MyNamespace
{
    public class MyClassCS
    {
        // Attribute to address CA1416 warning:
        // System.IO.FileSystem.AccessControl APIs are  only available on Windows
        [SupportedOSPlatform("windows")]
        static void Main()
        {
            // Create the file security object

            var identity = new SecurityIdentifier(WellKnownSidType.BuiltinUsersSid, null);
            var accessRule = new FileSystemAccessRule(identity, FileSystemRights.FullControl, AccessControlType.Allow);

            var security = new FileSecurity();
            security.AddAccessRule(accessRule);

            // Make sure the file does not exist, or FileMode.CreateNew will throw

            string filePath = Path.Combine(Path.GetTempPath(), "temp.txt");
            var fileInfo = new FileInfo(filePath);
            if (fileInfo.Exists)
            {
                fileInfo.Delete();
            }

            // Create the file with the specified security and write some text

            using (FileStream stream = fileInfo.Create(
                FileMode.CreateNew,
                FileSystemRights.FullControl,
                FileShare.ReadWrite,
                4096, // Default buffer size
                FileOptions.None,
                security))
            {
                string text = "Hello world!";
                byte[] writeBuffer = new UTF8Encoding(encoderShouldEmitUTF8Identifier: true).GetBytes(text);

                stream.Write(writeBuffer, 0, writeBuffer.Length);
            } // Dispose flushes the file to disk
        }
    }
}

Commenti

Questo metodo di estensione è stato aggiunto a .NET Core per fornire la funzionalità fornita da:This extension method was added to .NET Core to bring the functionality that was provided by:

Si applica a