MemoryMappedFile.CreateOrOpen Méthode
Définition
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
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability) |
Crée ou ouvre un fichier mappé en mémoire qui a la capacité, le nom, le type d’accès, l’allocation de mémoire, les autorisations de sécurité et les règles d’héritage spécifiés dans la mémoire système. |
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) |
Crée un fichier mappé en mémoire vide ou ouvre un fichier mappé en mémoire existant s’il en existe un du même nom. En cas d’ouverture d’un fichier existant, la capacité, les options et les arguments de mémoire sont ignorés. |
CreateOrOpen(String, Int64) |
Crée ou ouvre un fichier mappé en mémoire qui a la capacité et le nom spécifiés dans la mémoire système. |
CreateOrOpen(String, Int64, MemoryMappedFileAccess) |
Crée ou ouvre un fichier mappé en mémoire qui a la capacité, le nom et le type d’accès spécifiés dans la mémoire système. |
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)
Crée ou ouvre un fichier mappé en mémoire qui a la capacité, le nom, le type d’accès, l’allocation de mémoire, les autorisations de sécurité et les règles d’héritage 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, 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
L'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 d'opérations de bits de valeurs d'énumération qui spécifie des 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 aux opérations sur les fichiers mappés en mémoire.
Ce paramètre peut être null
.
- inheritability
- HandleInheritability
L'une des valeurs d'énumération qui spécifie si un processus enfant peut hériter d'un handle au fichier mappé en mémoire. La valeur par défaut est None.
Retours
Fichier mappé en mémoire qui possède les caractéristiques spécifiées.
- Attributs
Exceptions
mapName
a la valeur null
.
mapName
est une chaîne vide.
- ou -
access
est défini en écriture seule avec la valeur d’énumération Write.
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 MemoryMappedFileAccess valide.
- ou -
inheritability
n’est pas une valeur d’énumération HandleInheritability valide.
Le système d’exploitation a refusé l’access
spécifié au fichier ; par exemple, access
a la valeur Write 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 persistant (c’est-à-dire, non associé à un fichier sur disque), que vous pouvez utiliser pour partager des données entre des processus.
Voir aussi
S’applique à
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)
- Source:
- MemoryMappedFile.cs
- Source:
- MemoryMappedFile.cs
- Source:
- MemoryMappedFile.cs
Crée un fichier mappé en mémoire vide ou ouvre un fichier mappé en mémoire existant s’il en existe un du même nom. En cas d’ouverture d’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);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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);
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);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess * System.IO.MemoryMappedFiles.MemoryMappedFileOptions * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile
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
L'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 d’opérations de bits de valeurs qui indique les options d’allocation de mémoire à appliquer au fichier.
- inheritability
- HandleInheritability
Valeur qui spécifie si un processus enfant peut hériter d’un handle au fichier mappé en mémoire. La valeur par défaut est None.
Retours
Fichier mappé en mémoire qui possède les caractéristiques spécifiées.
- Attributs
Exceptions
mapName
a la valeur null
.
mapName
est une chaîne vide.
- ou -
access
est défini en écriture seule avec la valeur d’énumération Write.
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 MemoryMappedFileAccess valide.
- ou -
inheritability
n’est pas une valeur d’énumération HandleInheritability valide.
Le système d’exploitation a refusé l’accès spécifié au fichier ; par exemple, l’accès a la valeur Write ou ReadWrite, mais le fichier ou le répertoire est en lecture seule.
S’applique à
CreateOrOpen(String, Int64)
- Source:
- MemoryMappedFile.cs
- Source:
- MemoryMappedFile.cs
- Source:
- MemoryMappedFile.cs
Crée ou ouvre un fichier mappé en mémoire qui a la capacité et le nom spécifiés dans la mémoire système.
public:
static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity);
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateOrOpen : string * int64 -> System.IO.MemoryMappedFiles.MemoryMappedFile
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
Fichier mappé en mémoire qui possède le nom et la taille spécifiés.
- Attributs
Exceptions
mapName
est une chaîne vide.
capacity
est supérieur à la taille de l’espace d’adressage logique.
- ou -
capacity
est inférieur ou égal à zéro.
Remarques
Utilisez cette méthode pour créer ou ouvrir un fichier mappé en mémoire qui n’est pas persistant (c’est-à-dire, non associé à un fichier sur disque), que vous pouvez utiliser pour partager des données entre des processus.
Voir aussi
S’applique à
CreateOrOpen(String, Int64, MemoryMappedFileAccess)
- Source:
- MemoryMappedFile.cs
- Source:
- MemoryMappedFile.cs
- Source:
- MemoryMappedFile.cs
Crée ou ouvre un fichier mappé en mémoire qui a la capacité, le nom 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);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (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);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedFile
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
L'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
Fichier mappé en mémoire qui possède les caractéristiques spécifiées.
- Attributs
Exceptions
mapName
a la valeur null
.
mapName
est une chaîne vide.
- ou -
access
est défini en écriture seule avec la valeur d’énumération Write.
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 MemoryMappedFileAccess valide.
Le système d’exploitation a refusé l’accès spécifié au fichier ; par exemple, l’accès a la valeur Write 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 persistant (c’est-à-dire, non associé à un fichier sur disque), que vous pouvez utiliser pour partager des données entre des processus.