MemoryMappedFile.CreateOrOpen Méthode

Définition

Espace de noms:: System.IO.MemoryMappedFiles

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée ou ouvre un fichier mappé en mémoire dans la mémoire système.

Surcharges

Nom	Description
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)	Crée un fichier mappé de mémoire vide ou ouvre un fichier mappé de mémoire existant s’il en existe un portant le même nom. Si vous ouvrez un fichier existant, la capacité, les options et les arguments de mémoire sont ignorés.
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)	Crée ou ouvre un fichier mappé en mémoire qui a le nom, la capacité, le type d’accès, l’allocation de mémoire, les autorisations de sécurité et l’héritabilité dans la mémoire système spécifiée.
CreateOrOpen(String, Int64)	Crée ou ouvre un fichier mappé en mémoire qui a le nom et la capacité spécifiés dans la mémoire système.
CreateOrOpen(String, Int64, MemoryMappedFileAccess)	Crée ou ouvre un fichier mappé en mémoire avec le nom, la capacité et le type d’accès spécifiés dans la mémoire système.

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)

Crée un fichier mappé de mémoire vide ou ouvre un fichier mappé de mémoire existant s’il en existe un portant le même nom. Si vous ouvrez un fichier existant, la capacité, les options et les arguments de mémoire sont ignorés.

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access, System::IO::MemoryMappedFiles::MemoryMappedFileOptions options, System::IO::HandleInheritability inheritability);

public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen(string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access, System.IO.MemoryMappedFiles.MemoryMappedFileOptions options, System.IO.HandleInheritability inheritability);

static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess * System.IO.MemoryMappedFiles.MemoryMappedFileOptions * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess, options As MemoryMappedFileOptions, inheritability As HandleInheritability) As MemoryMappedFile

Paramètres

mapName: String

Nom du fichier mappé en mémoire.

capacity: Int64

Taille maximale, en octets, à allouer au fichier mappé en mémoire.

access: MemoryMappedFileAccess

Une des valeurs d’énumération qui spécifie le type d’accès autorisé au fichier mappé en mémoire. La valeur par défaut est ReadWrite.

options: MemoryMappedFileOptions

Combinaison de valeurs au niveau du bit qui indiquent les options d’allocation de mémoire à appliquer au fichier.

inheritability: HandleInheritability

Valeur qui spécifie si un handle vers le fichier mappé en mémoire peut être hérité par un processus enfant. La valeur par défaut est None.

Retours

MemoryMappedFile

Fichier mappé en mémoire qui a les caractéristiques spécifiées.

Exceptions

ArgumentNullException

mapName a la valeur null.

ArgumentException

mapName est une chaîne vide.

-ou-

access est défini sur écriture seule avec la valeur d’énumération Write .

ArgumentOutOfRangeException

capacity est supérieur à la taille de l’espace d’adressage logique.

-ou-

capacity est inférieur ou égal à zéro.

-ou-

access n’est pas une valeur d’énumération valide MemoryMappedFileAccess .

-ou-

inheritability n’est pas une valeur d’énumération valide HandleInheritability .

UnauthorizedAccessException

Le système d’exploitation a refusé l’accès spécifié au fichier ; Par exemple, l’accès est défini Write sur ou ReadWrite, mais le fichier ou le répertoire est en lecture seule.

S’applique à

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)

Crée ou ouvre un fichier mappé en mémoire qui a le nom, la capacité, le type d’accès, l’allocation de mémoire, les autorisations de sécurité et l’héritabilité dans la mémoire système spécifiée.

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access, System::IO::MemoryMappedFiles::MemoryMappedFileOptions options, System::IO::MemoryMappedFiles::MemoryMappedFileSecurity ^ memoryMappedFileSecurity, System::IO::HandleInheritability inheritability);

[System.Security.SecurityCritical]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen(string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access, System.IO.MemoryMappedFiles.MemoryMappedFileOptions options, System.IO.MemoryMappedFiles.MemoryMappedFileSecurity memoryMappedFileSecurity, System.IO.HandleInheritability inheritability);

[<System.Security.SecurityCritical>]
static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess * System.IO.MemoryMappedFiles.MemoryMappedFileOptions * System.IO.MemoryMappedFiles.MemoryMappedFileSecurity * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess, options As MemoryMappedFileOptions, memoryMappedFileSecurity As MemoryMappedFileSecurity, inheritability As HandleInheritability) As MemoryMappedFile

Paramètres

mapName: String

Nom du fichier mappé en mémoire.

capacity: Int64

Taille maximale, en octets, à allouer au fichier mappé en mémoire.

access: MemoryMappedFileAccess

Une des valeurs d’énumération qui spécifie le type d’accès autorisé au fichier mappé en mémoire. La valeur par défaut est ReadWrite.

options: MemoryMappedFileOptions

Combinaison de bits de valeurs d’énumération qui spécifie les options d’allocation de mémoire pour le fichier mappé en mémoire.

memoryMappedFileSecurity: MemoryMappedFileSecurity

Autorisations qui peuvent être accordées pour l’accès aux fichiers et les opérations sur les fichiers mappés en mémoire.

Ce paramètre peut être null.

inheritability: HandleInheritability

Une des valeurs d’énumération qui spécifie si un handle vers le fichier mappé en mémoire peut être hérité par un processus enfant. La valeur par défaut est None.

Retours

MemoryMappedFile

Fichier mappé en mémoire qui a les caractéristiques spécifiées.

Attributs: SecurityCriticalAttribute

Exceptions

ArgumentNullException

mapName a la valeur null.

ArgumentException

mapName est une chaîne vide.

-ou-

access est défini sur écriture seule avec la valeur d’énumération Write .

ArgumentOutOfRangeException

capacity est supérieur à la taille de l’espace d’adressage logique.

-ou-

capacity est inférieur ou égal à zéro.

-ou-

access n’est pas une valeur d’énumération valide MemoryMappedFileAccess .

-ou-

inheritability n’est pas une valeur d’énumération valide HandleInheritability .

UnauthorizedAccessException

Le système d’exploitation a refusé le fichier spécifié access ; par exemple, access est défini Write sur ou ReadWrite, mais le fichier ou le répertoire est en lecture seule.

Remarques

Utilisez cette méthode pour créer ou ouvrir un fichier mappé en mémoire qui n’est pas conservé (autrement dit, non associé à un fichier sur disque), que vous pouvez utiliser pour partager des données entre les processus.

Voir aussi

Fichiers mappés en mémoire

S’applique à

CreateOrOpen(String, Int64)

Crée ou ouvre un fichier mappé en mémoire qui a le nom et la capacité spécifiés dans la mémoire système.

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity);

public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen(string mapName, long capacity);

static member CreateOrOpen : string * int64 -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function CreateOrOpen (mapName As String, capacity As Long) As MemoryMappedFile

Paramètres

mapName: String

Nom du fichier mappé en mémoire.

capacity: Int64

Taille maximale, en octets, à allouer au fichier mappé en mémoire.

Retours

MemoryMappedFile

Fichier mappé en mémoire qui a le nom et la taille spécifiés.

Exceptions

ArgumentException

mapName est une chaîne vide.

ArgumentOutOfRangeException

capacity est supérieur à la taille de l’espace d’adressage logique.

-ou-

capacity est inférieur ou égal à zéro.

Remarques

Voir aussi

Fichiers mappés en mémoire

S’applique à

CreateOrOpen(String, Int64, MemoryMappedFileAccess)

Crée ou ouvre un fichier mappé en mémoire avec le nom, la capacité et le type d’accès spécifiés dans la mémoire système.

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access);

public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen(string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);

static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess) As MemoryMappedFile

Paramètres

mapName: String

Nom du fichier mappé en mémoire.

capacity: Int64

Taille maximale, en octets, à allouer au fichier mappé en mémoire.

access: MemoryMappedFileAccess

Une des valeurs d’énumération qui spécifie le type d’accès autorisé au fichier mappé en mémoire. La valeur par défaut est ReadWrite.

Retours

MemoryMappedFile

Fichier mappé en mémoire qui a les caractéristiques spécifiées.

Exceptions

ArgumentNullException

mapName a la valeur null.

ArgumentException

mapName est une chaîne vide.

-ou-

access est défini sur écriture seule avec la valeur d’énumération Write .

ArgumentOutOfRangeException

capacity est supérieur à la taille de l’espace d’adressage logique.

-ou-

capacity est inférieur ou égal à zéro.

-ou-

access n’est pas une valeur d’énumération valide MemoryMappedFileAccess .

UnauthorizedAccessException

Le système d’exploitation a refusé l’accès spécifié au fichier ; Par exemple, l’accès est défini Write sur ou ReadWrite, mais le fichier ou le répertoire est en lecture seule.

Remarques

Voir aussi

Fichiers mappés en mémoire

S’applique à

Commentaires

Cette page a-t-elle été utile ?