FileSystemAclExtensions.Create Méthode

Définition

Surcharges

Create(DirectoryInfo, DirectorySecurity)

Crée un répertoire en veillant à ce qu’il soit créé avec la sécurité de répertoire spécifiée.Creates a new directory, ensuring it is created with the specified directory security. Si le répertoire existe déjà, aucune action n’est entreprise.If the directory already exists, nothing is done.

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

Crée un flux de fichier en veillant à ce qu’il soit créé avec les propriétés et les paramètres de sécurité spécifiés.Creates a new file stream, ensuring it is created with the specified properties and security settings.

Create(DirectoryInfo, DirectorySecurity)

Crée un répertoire en veillant à ce qu’il soit créé avec la sécurité de répertoire spécifiée.Creates a new directory, ensuring it is created with the specified directory security. Si le répertoire existe déjà, aucune action n’est entreprise.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)

Paramètres

directoryInfo
DirectoryInfo

Répertoire qui n’existe pas encore et qui sera créé par la méthode.A directory that does not exist yet that will be created by the method.

directorySecurity
DirectorySecurity

Sécurité du contrôle d’accès et de l’audit d’un répertoire.The access control and audit security for the directory.

Exceptions

directoryInfo ou directorySecurity est null.directoryInfo or directorySecurity is null.

Impossible de trouver une partie du chemin.Could not find a part of the path.

L’accès au chemin est refusé.Access to the path is denied.

Exemples

L’exemple de code suivant crée un répertoire à l’intérieur du dossier temporaire de l’utilisateur avec les attributs de sécurité de répertoire spécifiés :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.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);
        }
    }
}

Remarques

Cette méthode d’extension a été ajoutée à .NET Core pour apporter les fonctionnalités fournies par la méthode DirectoryInfo. Create (DirectorySecurity) .NET Framework.This extension method was added to .NET Core to bring the functionality that was provided by the DirectoryInfo.Create(DirectorySecurity) .NET Framework method.

S’applique à

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

Crée un flux de fichier en veillant à ce qu’il soit créé avec les propriétés et les paramètres de sécurité spécifiés.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

Paramètres

fileInfo
FileInfo

Fichier qui n’existe pas encore et qui sera créé par la méthode.A file that does not exist yet that will be created by the method.

mode
FileMode

Une des valeurs d’énumération qui spécifie le mode d’ouverture d’un fichier par le système d’exploitation.One of the enumeration values that specifies how the operating system should open a file.

rights
FileSystemRights

Une des valeurs d’énumération qui définit les droits d’accès à utiliser lors de la création de règles d'accès et d'audit.One of the enumeration values that defines the access rights to use when creating access and audit rules.

share
FileShare

Une des valeurs d’énumération pour contrôler le type d’accès que d’autres objets de flux de fichier peuvent avoir à un même fichier.One of the enumeration values for controlling the kind of access other file stream objects can have to the same file.

bufferSize
Int32

Nombre d'octets mis en mémoire tampon pour les opérations de lecture et d'écriture dans le fichier.The number of bytes buffered for reads and writes to the file.

options
FileOptions

Une des valeurs d’énumération qui décrit comment créer ou remplacer le fichier.One of the enumeration values that describes how to create or overwrite the file.

fileSecurity
FileSecurity

Objet qui détermine la sécurité de contrôle d’accès et d’audit du fichier.An object that determines the access control and audit security for the file.

Retours

FileStream

Flux de fichier pour le fichier qui vient d’être créé.A file stream for the newly created file.

Exceptions

La combinaison rights et mode n’est pas valide.The rights and mode combination is invalid.

fileInfo ou fileSecurity est null.fileInfo or fileSecurity is null.

mode ou share sont hors de leur plage d’énumération légale.mode or share are out of their legal enum range.

- ou --or-

bufferSize n’est pas un nombre positif.bufferSize is not a positive number.

Impossible de trouver une partie du chemin.Could not find a part of the path.

Une erreur d'E/S s'est produite.An I/O error occurred.

L’accès au chemin est refusé.Access to the path is denied.

Exemples

L’exemple de code suivant crée un nouveau fichier texte (avec la taille de mémoire tampon par défaut 4096) dans le dossier temporaire de l’utilisateur avec les attributs de sécurité de fichier spécifiés :The following code example creates a new text file (with the default buffer size of 4096) inside the user's temporary folder with the specified file security attributes:

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

namespace ConsoleApp
{
    class Program
    {
        static void Main()
        {
            FileSecurity security = new FileSecurity();

            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(), "fileToCreate.txt");

            FileInfo fileInfo = new FileInfo(path);

            fileInfo.Create(FileMode.Create, FileSystemRights.FullControl, FileShare.Read, 4096, FileOptions.None, security);
        }
    }
}

Remarques

Cette méthode d’extension a été ajoutée à .NET Core pour apporter les fonctionnalités fournies par :This extension method was added to .NET Core to bring the functionality that was provided by:

S’applique à