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 Speicherabbilddatei im Systemspeicher.
Überlädt
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability) |
Erstellt oder öffnet eine im Speicher abgebildete Datei mit den angegebenen Werten für Kapazität, Zugriffstyp, Speicherbelegung, Sicherheitsberechtigungen und Vererbbarkeit im Systemspeicher. |
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) |
Erstellt eine neue leere im Speicher abgebildete Datei oder öffnet eine vorhandene im Speicher abgebildete Datei, wenn eine Datei mit diesem Namen existiert. Wenn Sie eine vorhandene Datei angeben, werden die Werte für Kapazität, Optionen und Speicherargumente ignoriert. |
CreateOrOpen(String, Int64) |
Erstellt oder öffnet eine im Speicher abgebildete Datei mit dem angegebenen Namen und der angegebenen Kapazität im Systemspeicher. |
CreateOrOpen(String, Int64, MemoryMappedFileAccess) |
Erstellt oder öffnet eine im Speicher abgebildete Datei mit den angegebenen Werten für Name, Kapazität und Zugriffstyp im Systemspeicher. |
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)
Erstellt oder öffnet eine im Speicher abgebildete Datei mit den angegebenen Werten für Kapazität, Zugriffstyp, Speicherbelegung, Sicherheitsberechtigungen und Vererbbarkeit 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.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
Parameter
- mapName
- String
Der Name der im Speicher abgebildeten Datei.
- capacity
- Int64
Die maximale Größe (in Bytes), die für die Speicherabbilddatei reserviert werden soll.
- access
- MemoryMappedFileAccess
Einer der Enumerationswerte, der den zulässigen Zugriffstyp für die Speicherabbilddatei angibt. Der Standardwert ist ReadWrite.
- options
- MemoryMappedFileOptions
Eine bitweise Kombination von Enumerationswerten, die Speicherbelegungsoptionen für die Speicherabbilddatei angeben.
- memoryMappedFileSecurity
- MemoryMappedFileSecurity
Die Berechtigungen, die für den Dateizugriff und für Vorgänge für Speicherabbilddateien gewährt werden können.
Dieser Parameter kann null
sein.
- inheritability
- HandleInheritability
Einer der Enumerationswerte, der angibt, ob ein Handle auf die Speicherabbilddatei von einem untergeordneten Prozess geerbt werden kann. Der Standardwert ist None.
Gibt zurück
Eine Speicherabbilddatei, die die angegebenen Merkmale aufweist.
- Attribute
Ausnahmen
mapName
ist null
.
mapName
ist eine leere Zeichenfolge.
- oder -
access
ist mit dem Write-Enumerationswert auf „Nur Schreibzugriff“ festgelegt.
capacity
ist größer als die Größe des logischen Adressbereichs.
- oder -
capacity
ist kleiner oder gleich 0 (null).
- oder -
access
ist kein gültiger MemoryMappedFileAccess-Enumerationswert.
- oder -
inheritability
ist kein gültiger HandleInheritability-Enumerationswert.
Das Betriebssystem hat den angegebenen access
auf die Datei verweigert. access
ist z. B. auf Write oder ReadWrite festgelegt, aber die Datei oder das Verzeichnis ist schreibgeschützt.
Hinweise
Verwenden Sie diese Methode, um eine Datei mit Speicherzuordnung zu erstellen oder zu öffnen, die nicht dauerhaft gespeichert ist (d. h. nicht mit einer Datei auf dem Datenträger verknüpft ist), die Sie verwenden können, um Daten zwischen Prozessen freizugeben.
Weitere Informationen
Gilt für:
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
Erstellt eine neue leere im Speicher abgebildete Datei oder öffnet eine vorhandene im Speicher abgebildete Datei, wenn eine Datei mit diesem Namen existiert. Wenn Sie eine vorhandene Datei angeben, werden die Werte für Kapazität, 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);
[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
Parameter
- mapName
- String
Der Name der im Speicher abgebildeten Datei.
- capacity
- Int64
Die maximale Größe (in Bytes), die für die Speicherabbilddatei reserviert werden soll.
- access
- MemoryMappedFileAccess
Einer der Enumerationswerte, der den zulässigen Zugriffstyp für die Speicherabbilddatei angibt. Der Standardwert ist ReadWrite.
- options
- MemoryMappedFileOptions
Eine bitweise Kombination von Werten, die Speicherbelegungsoptionen für die Datei angeben.
- inheritability
- HandleInheritability
Ein Wert, der angibt, ob ein Handle auf die Speicherabbilddatei von einem untergeordneten Prozess geerbt werden kann. Der Standardwert ist None.
Gibt zurück
Eine Speicherabbilddatei, die die angegebenen Merkmale aufweist.
- Attribute
Ausnahmen
mapName
ist null
.
mapName
ist eine leere Zeichenfolge.
- oder -
access
ist mit dem Write-Enumerationswert auf „Nur Schreibzugriff“ festgelegt.
capacity
ist größer als die Größe des logischen Adressbereichs.
- oder -
capacity
ist kleiner oder gleich 0 (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. access ist z. B. auf Write oder ReadWrite festgelegt, aber die Datei oder das Verzeichnis ist schreibgeschützt.
Gilt für:
CreateOrOpen(String, Int64)
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
Erstellt oder öffnet eine im Speicher abgebildete Datei mit dem angegebenen Namen und der angegebenen Kapazität im Systemspeicher.
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
Parameter
- mapName
- String
Der Name der im Speicher abgebildeten Datei.
- capacity
- Int64
Die maximale Größe (in Bytes), die für die Speicherabbilddatei reserviert werden soll.
Gibt zurück
Eine Speicherabbilddatei, die den angegebenen Namen und die angegebene Größe aufweist.
- Attribute
Ausnahmen
mapName
ist eine leere Zeichenfolge.
capacity
ist größer als die Größe des logischen Adressbereichs.
- oder -
capacity
ist kleiner oder gleich 0 (null).
Hinweise
Verwenden Sie diese Methode, um eine Datei mit Speicherzuordnung zu erstellen oder zu öffnen, die nicht dauerhaft gespeichert ist (d. h. nicht mit einer Datei auf dem Datenträger verknüpft ist), die Sie verwenden können, um Daten zwischen Prozessen freizugeben.
Weitere Informationen
Gilt für:
CreateOrOpen(String, Int64, MemoryMappedFileAccess)
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
Erstellt oder öffnet eine im Speicher abgebildete Datei mit den angegebenen Werten für Name, Kapazität und Zugriffstyp im Systemspeicher.
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
Parameter
- mapName
- String
Der Name der im Speicher abgebildeten Datei.
- capacity
- Int64
Die maximale Größe (in Bytes), die für die Speicherabbilddatei reserviert werden soll.
- access
- MemoryMappedFileAccess
Einer der Enumerationswerte, der den zulässigen Zugriffstyp für die Speicherabbilddatei angibt. Der Standardwert ist ReadWrite.
Gibt zurück
Eine Speicherabbilddatei, die die angegebenen Merkmale aufweist.
- Attribute
Ausnahmen
mapName
ist null
.
mapName
ist eine leere Zeichenfolge.
- oder -
access
ist mit dem Write-Enumerationswert auf „Nur Schreibzugriff“ festgelegt.
capacity
ist größer als die Größe des logischen Adressbereichs.
- oder -
capacity
ist kleiner oder gleich 0 (null).
- oder -
access
ist kein gültiger MemoryMappedFileAccess-Enumerationswert.
Das Betriebssystem hat den angegebenen Zugriff auf die Datei verweigert. access ist z. B. auf Write oder ReadWrite festgelegt, aber die Datei oder das Verzeichnis ist schreibgeschützt.
Hinweise
Verwenden Sie diese Methode, um eine Datei mit Speicherzuordnung zu erstellen oder zu öffnen, die nicht dauerhaft gespeichert ist (d. h. nicht mit einer Datei auf dem Datenträger verknüpft ist), die Sie verwenden können, um Daten zwischen Prozessen freizugeben.