Freigeben über


MemoryMappedFile.CreateOrOpen Methode

Definition

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.

Weitere Informationen

Gilt für: