MemoryMappedFile.CreateOrOpen Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt oder öffnet eine speicherzuordnunge Datei im Systemspeicher.
Überlädt
| Name | Beschreibung |
|---|---|
| CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) |
Erstellt eine neue leere zugeordnete Speicherdatei oder öffnet eine vorhandene zugeordnete Speicherdatei, wenn eine datei mit demselben Namen vorhanden ist. Wenn Sie eine vorhandene Datei öffnen, werden die Kapazitäts-, Optionen- und Speicherargumente ignoriert. |
| CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability) |
Erstellt oder öffnet eine im Arbeitsspeicher zugeordnete Datei mit dem angegebenen Namen, der Kapazität, dem Zugriffstyp, der Speicherzuweisung, sicherheitsberechtigungen und der Vererbungsfähigkeit im Systemspeicher. |
| CreateOrOpen(String, Int64) |
Erstellt oder öffnet eine speicherzuordnunge Datei mit dem angegebenen Namen und der angegebenen Kapazität im Systemspeicher. |
| CreateOrOpen(String, Int64, MemoryMappedFileAccess) |
Erstellt oder öffnet eine im Arbeitsspeicher zugeordnete Datei mit dem angegebenen Namen, der Kapazität und dem Zugriffstyp im Systemspeicher. |
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)
Erstellt eine neue leere zugeordnete Speicherdatei oder öffnet eine vorhandene zugeordnete Speicherdatei, wenn eine datei mit demselben Namen vorhanden ist. Wenn Sie eine vorhandene Datei öffnen, werden die Kapazitäts-, Optionen- und Speicherargumente ignoriert.
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.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess, options As MemoryMappedFileOptions, inheritability As HandleInheritability) As MemoryMappedFileParameter
- mapName
- String
Der Name der speicherzuordnungen Datei.
- capacity
- Int64
Die maximale Größe in Byte, die der speicherzuordnungen Datei zugeordnet werden soll.
- access
- MemoryMappedFileAccess
Einer der Enumerationswerte, der den Typ des Zugriffs angibt, der für die speicherzuordnunge Datei zulässig ist. Der Standardwert lautet ReadWrite.
- options
- MemoryMappedFileOptions
Eine bitweise Kombination von Werten, die die Speicherzuweisungsoptionen für die Datei angeben.
- inheritability
- HandleInheritability
Ein Wert, der angibt, ob ein Handle für die speicherzuordnunge Datei von einem untergeordneten Prozess geerbt werden kann. Der Standardwert lautet None.
Gibt zurück
Eine speicherzuordnunge Datei mit den angegebenen Merkmalen.
Ausnahmen
mapName ist null.
mapName ist eine leere Zeichenfolge.
-oder-
access ist auf schreibgeschützt mit dem Write Enumerationswert festgelegt.
capacity ist größer als die Größe des logischen Adressraums.
-oder-
capacity ist kleiner oder gleich Null.
-oder-
access ist kein gültiger MemoryMappedFileAccess Enumerationswert.
-oder-
inheritability ist kein gültiger HandleInheritability Enumerationswert.
Das Betriebssystem hat den angegebenen Zugriff auf die Datei verweigert; Der Zugriff ist beispielsweise auf Write oder ReadWrite, aber die Datei oder das Verzeichnis ist schreibgeschützt.
Gilt für:
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)
Erstellt oder öffnet eine im Arbeitsspeicher zugeordnete Datei mit dem angegebenen Namen, der Kapazität, dem Zugriffstyp, der Speicherzuweisung, sicherheitsberechtigungen und der Vererbungsfähigkeit im Systemspeicher.
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.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess, options As MemoryMappedFileOptions, memoryMappedFileSecurity As MemoryMappedFileSecurity, inheritability As HandleInheritability) As MemoryMappedFileParameter
- mapName
- String
Der Name der speicherzuordnungen Datei.
- capacity
- Int64
Die maximale Größe in Byte, die der speicherzuordnungen Datei zugeordnet werden soll.
- access
- MemoryMappedFileAccess
Einer der Enumerationswerte, der den Typ des Zugriffs angibt, der für die speicherzuordnunge Datei zulässig ist. Der Standardwert lautet ReadWrite.
- options
- MemoryMappedFileOptions
Eine bitweise Kombination von Enumerationswerten, die Speicherzuordnungsoptionen für die speicherzuordnungsdatei angibt.
- memoryMappedFileSecurity
- MemoryMappedFileSecurity
Die Berechtigungen, die für Dateizugriff und Vorgänge für dateien zugeordnete Dateien gewährt werden können.
Dieser Parameter kann null sein.
- inheritability
- HandleInheritability
Einer der Enumerationswerte, der angibt, ob ein Handle für die speicherzuordnunge Datei von einem untergeordneten Prozess geerbt werden kann. Der Standardwert lautet None.
Gibt zurück
Eine speicherzuordnunge Datei mit den angegebenen Merkmalen.
- Attribute
Ausnahmen
mapName ist null.
mapName ist eine leere Zeichenfolge.
-oder-
access ist auf schreibgeschützt mit dem Write Enumerationswert festgelegt.
capacity ist größer als die Größe des logischen Adressraums.
-oder-
capacity ist kleiner oder gleich Null.
-oder-
access ist kein gültiger MemoryMappedFileAccess Enumerationswert.
-oder-
inheritability ist kein gültiger HandleInheritability Enumerationswert.
Das Betriebssystem hat die angegebene access Datei verweigert, access z. B. ist auf Write oder ReadWrite, aber die Datei oder das Verzeichnis ist schreibgeschützt.
Hinweise
Verwenden Sie diese Methode, um eine speicherzuordnunge Datei zu erstellen oder zu öffnen, die nicht beibehalten wird (d. h. nicht mit einer Datei auf dem Datenträger verknüpft), die Sie zum Freigeben von Daten zwischen Prozessen verwenden können.
Weitere Informationen
Gilt für:
CreateOrOpen(String, Int64)
Erstellt oder öffnet eine speicherzuordnunge Datei mit dem angegebenen Namen und der angegebenen Kapazität im Systemspeicher.
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.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long) As MemoryMappedFileParameter
- mapName
- String
Der Name der speicherzuordnungen Datei.
- capacity
- Int64
Die maximale Größe in Byte, die der speicherzuordnungen Datei zugeordnet werden soll.
Gibt zurück
Eine speicherzuordnunge Datei mit dem angegebenen Namen und der angegebenen Größe.
Ausnahmen
mapName ist eine leere Zeichenfolge.
capacity ist größer als die Größe des logischen Adressraums.
-oder-
capacity ist kleiner oder gleich Null.
Hinweise
Verwenden Sie diese Methode, um eine speicherzuordnunge Datei zu erstellen oder zu öffnen, die nicht beibehalten wird (d. h. nicht mit einer Datei auf dem Datenträger verknüpft), die Sie zum Freigeben von Daten zwischen Prozessen verwenden können.
Weitere Informationen
Gilt für:
CreateOrOpen(String, Int64, MemoryMappedFileAccess)
Erstellt oder öffnet eine im Arbeitsspeicher zugeordnete Datei mit dem angegebenen Namen, der Kapazität und dem Zugriffstyp im Systemspeicher.
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.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess) As MemoryMappedFileParameter
- mapName
- String
Der Name der speicherzuordnungen Datei.
- capacity
- Int64
Die maximale Größe in Byte, die der speicherzuordnungen Datei zugeordnet werden soll.
- access
- MemoryMappedFileAccess
Einer der Enumerationswerte, der den Typ des Zugriffs angibt, der für die speicherzuordnunge Datei zulässig ist. Der Standardwert lautet ReadWrite.
Gibt zurück
Eine speicherzuordnunge Datei mit den angegebenen Merkmalen.
Ausnahmen
mapName ist null.
mapName ist eine leere Zeichenfolge.
-oder-
access ist auf schreibgeschützt mit dem Write Enumerationswert festgelegt.
capacity ist größer als die Größe des logischen Adressraums.
-oder-
capacity ist kleiner oder gleich Null.
-oder-
access ist kein gültiger MemoryMappedFileAccess Enumerationswert.
Das Betriebssystem hat den angegebenen Zugriff auf die Datei verweigert; Der Zugriff ist beispielsweise auf Write oder ReadWrite, aber die Datei oder das Verzeichnis ist schreibgeschützt.
Hinweise
Verwenden Sie diese Methode, um eine speicherzuordnunge Datei zu erstellen oder zu öffnen, die nicht beibehalten wird (d. h. nicht mit einer Datei auf dem Datenträger verknüpft), die Sie zum Freigeben von Daten zwischen Prozessen verwenden können.