MemoryMappedFile.CreateOrOpen MemoryMappedFile.CreateOrOpen MemoryMappedFile.CreateOrOpen MemoryMappedFile.CreateOrOpen Method

Definition

Erstellt oder öffnet eine Speicherabbilddatei im Systemspeicher.Creates or opens a memory-mapped file in system memory.

Überlädt

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) 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.Creates a new empty memory mapped file or opens an existing memory mapped file if one exists with the same name. Wenn Sie eine vorhandene Datei angeben, werden die Werte für Kapazität, Optionen und Speicherargumente ignoriert.If opening an existing file, the capacity, options, and memory arguments will be ignored.

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability) CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability) 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.Creates or opens a memory-mapped file that has the specified name, capacity, access type, memory allocation, security permissions, and inheritability in system memory.

CreateOrOpen(String, Int64) CreateOrOpen(String, Int64) CreateOrOpen(String, Int64) CreateOrOpen(String, Int64)

Erstellt oder öffnet eine im Speicher abgebildete Datei mit dem angegebenen Namen und der angegebenen Kapazität im Systemspeicher.Creates or opens a memory-mapped file that has the specified name and capacity in system memory.

CreateOrOpen(String, Int64, MemoryMappedFileAccess) CreateOrOpen(String, Int64, MemoryMappedFileAccess) CreateOrOpen(String, Int64, MemoryMappedFileAccess) 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.Creates or opens a memory-mapped file that has the specified name, capacity and access type in system memory.

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) 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.Creates a new empty memory mapped file or opens an existing memory mapped file if one exists with the same name. Wenn Sie eine vorhandene Datei angeben, werden die Werte für Kapazität, Optionen und Speicherargumente ignoriert.If opening an existing file, the capacity, options, and memory arguments will be ignored.

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

Parameter

mapName
String String String String

Der Name der im Speicher abgebildeten Datei.The name of the memory-mapped file.

capacity
Int64 Int64 Int64 Int64

Die maximale Größe (in Bytes), die für die Speicherabbilddatei reserviert werden soll.The maximum size, in bytes, to allocate to the memory-mapped file.

access
MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess

Einer der Enumerationswerte, der den zulässigen Zugriffstyp für die Speicherabbilddatei angibt.One of the enumeration values that specifies the type of access allowed to the memory-mapped file. Der Standardwert ist ReadWrite.The default is ReadWrite.

options
MemoryMappedFileOptions MemoryMappedFileOptions MemoryMappedFileOptions MemoryMappedFileOptions

Eine bitweise Kombination von Werten, die Speicherbelegungsoptionen für die Datei angeben.A bitwise combination of values that indicate the memory allocation options to apply to the file.

inheritability
HandleInheritability HandleInheritability HandleInheritability HandleInheritability

Ein Wert, der angibt, ob ein Handle auf die Speicherabbilddatei von einem untergeordneten Prozess geerbt werden kann.A value that specifies whether a handle to the memory-mapped file can be inherited by a child process. Der Standardwert ist None.The default is None.

Gibt zurück

Eine Speicherabbilddatei, die die angegebenen Merkmale aufweist.A memory-mapped file that has the specified characteristics.

Ausnahmen

mapName ist eine leere Zeichenfolge.mapName is an empty string.

- oder --or- access wird mit dem Write-Enumerationswert auf lesegeschützt festgelegt.access is set to write-only with the Write enumeration value.

capacity ist größer als die Größe des logischen Adressbereichs.capacity is greater than the size of the logical address space.

- oder --or- capacity ist kleiner oder gleich 0 (null).capacity is less than or equal to zero.

- oder - -or- access ist kein gültiger MemoryMappedFileAccess-Enumerationswert.access is not a valid MemoryMappedFileAccess enumeration value.

- oder --or- inheritability ist kein gültiger HandleInheritability-Enumerationswert.inheritability is not a valid HandleInheritability enumeration value.

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.The operating system denied the specified access to the file; for example, access is set to Write or ReadWrite, but the file or directory is read-only.

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability) CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability) 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.Creates or opens a memory-mapped file that has the specified name, capacity, access type, memory allocation, security permissions, and inheritability in system memory.

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);
static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess * System.IO.MemoryMappedFiles.MemoryMappedFileOptions * System.IO.MemoryMappedFiles.MemoryMappedFileSecurity * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile

Parameter

mapName
String String String String

Der Name der im Speicher abgebildeten Datei.The name of the memory-mapped file.

capacity
Int64 Int64 Int64 Int64

Die maximale Größe (in Bytes), die für die Speicherabbilddatei reserviert werden soll.The maximum size, in bytes, to allocate to the memory-mapped file.

access
MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess

Einer der Enumerationswerte, der den zulässigen Zugriffstyp für die Speicherabbilddatei angibt.One of the enumeration values that specifies the type of access allowed to the memory-mapped file. Der Standardwert ist ReadWrite.The default is ReadWrite.

options
MemoryMappedFileOptions MemoryMappedFileOptions MemoryMappedFileOptions MemoryMappedFileOptions

Eine bitweise Kombination von Enumerationswerten, die Speicherbelegungsoptionen für die Speicherabbilddatei angeben.A bitwise combination of enumeration values that specifies memory allocation options for the memory-mapped file.

memoryMappedFileSecurity
MemoryMappedFileSecurity MemoryMappedFileSecurity MemoryMappedFileSecurity MemoryMappedFileSecurity

Die Berechtigungen, die für den Dateizugriff und für Vorgänge für Speicherabbilddateien gewährt werden können.The permissions that can be granted for file access and operations on memory-mapped files.

Dieser Parameter kann null sein.This parameter can be null.

inheritability
HandleInheritability HandleInheritability HandleInheritability HandleInheritability

Einer der Enumerationswerte, der angibt, ob ein Handle auf die Speicherabbilddatei von einem untergeordneten Prozess geerbt werden kann.One of the enumeration values that specifies whether a handle to the memory-mapped file can be inherited by a child process. Der Standardwert ist None.The default is None.

Gibt zurück

Eine Speicherabbilddatei, die die angegebenen Merkmale aufweist.A memory-mapped file that has the specified characteristics.

Ausnahmen

mapName ist eine leere Zeichenfolge.mapName is an empty string.

- oder --or- access wird mit dem Write-Enumerationswert auf lesegeschützt festgelegt.access is set to write-only with the Write enumeration value.

capacity ist größer als die Größe des logischen Adressbereichs.capacity is greater than the size of the logical address space.

- oder --or- capacity ist kleiner oder gleich 0 (null).capacity is less than or equal to zero.

- oder - -or- access ist kein gültiger MemoryMappedFileAccess-Enumerationswert.access is not a valid MemoryMappedFileAccess enumeration value.

- oder --or- inheritability ist kein gültiger HandleInheritability-Enumerationswert.inheritability is not a valid HandleInheritability enumeration value.

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.The operating system denied the specified access to the file; for example, access is set to Write or ReadWrite, but the file or directory is read-only.

Hinweise

Verwenden Sie diese Methode zum Erstellen oder öffnen eine Datei mit zugewiesenem Speicher, die nicht persistent gespeichert wird (d. h. keine Datei auf dem Datenträger zugeordnet), die Sie zum Freigeben von Daten zwischen Prozessen verwenden können.Use this method to create or open a memory-mapped file that is not persisted (that is, not associated with a file on disk), which you can use to share data between processes.

Sicherheit

SecurityPermission
für den Zugriff von nicht verwaltetem Code.for access to unmanaged code. Zugeordnete Enumeration: UnmanagedCodeAssociated enumeration: UnmanagedCode.

Siehe auch

CreateOrOpen(String, Int64) CreateOrOpen(String, Int64) CreateOrOpen(String, Int64) CreateOrOpen(String, Int64)

Erstellt oder öffnet eine im Speicher abgebildete Datei mit dem angegebenen Namen und der angegebenen Kapazität im Systemspeicher.Creates or opens a memory-mapped file that has the specified name and capacity in system memory.

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

Parameter

mapName
String String String String

Der Name der im Speicher abgebildeten Datei.The name of the memory-mapped file.

capacity
Int64 Int64 Int64 Int64

Die maximale Größe (in Bytes), die für die Speicherabbilddatei reserviert werden soll.The maximum size, in bytes, to allocate to the memory-mapped file.

Gibt zurück

Eine Speicherabbilddatei, die den angegebenen Namen und die angegebene Größe aufweist.A memory-mapped file that has the specified name and size.

Ausnahmen

mapName ist eine leere Zeichenfolge.mapName is an empty string.

capacity ist größer als die Größe des logischen Adressbereichs.capacity is greater than the size of the logical address space.

- oder --or- capacity ist kleiner oder gleich 0 (null).capacity is less than or equal to zero.

Hinweise

Verwenden Sie diese Methode zum Erstellen oder öffnen eine Datei mit zugewiesenem Speicher, die nicht persistent gespeichert wird (d. h. keine Datei auf dem Datenträger zugeordnet), die Sie zum Freigeben von Daten zwischen Prozessen verwenden können.Use this method to create or open a memory-mapped file that is not persisted (that is, not associated with a file on disk), which you can use to share data between processes.

Siehe auch

CreateOrOpen(String, Int64, MemoryMappedFileAccess) CreateOrOpen(String, Int64, MemoryMappedFileAccess) CreateOrOpen(String, Int64, MemoryMappedFileAccess) 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.Creates or opens a memory-mapped file that has the specified name, capacity and access type in system memory.

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

Parameter

mapName
String String String String

Der Name der im Speicher abgebildeten Datei.The name of the memory-mapped file.

capacity
Int64 Int64 Int64 Int64

Die maximale Größe (in Bytes), die für die Speicherabbilddatei reserviert werden soll.The maximum size, in bytes, to allocate to the memory-mapped file.

access
MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess

Einer der Enumerationswerte, der den zulässigen Zugriffstyp für die Speicherabbilddatei angibt.One of the enumeration values that specifies the type of access allowed to the memory-mapped file. Der Standardwert ist ReadWrite.The default is ReadWrite.

Gibt zurück

Eine Speicherabbilddatei, die die angegebenen Merkmale aufweist.A memory-mapped file that has the specified characteristics.

Ausnahmen

mapName ist eine leere Zeichenfolge.mapName is an empty string.

- oder --or- access wird mit dem Write-Enumerationswert auf lesegeschützt festgelegt.access is set to write-only with the Write enumeration value.

capacity ist größer als die Größe des logischen Adressbereichs.capacity is greater than the size of the logical address space.

- oder --or- capacity ist kleiner oder gleich 0 (null).capacity is less than or equal to zero.

- oder - -or- access ist kein gültiger MemoryMappedFileAccess-Enumerationswert.access is not a valid MemoryMappedFileAccess enumeration value.

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.The operating system denied the specified access to the file; for example, access is set to Write or ReadWrite, but the file or directory is read-only.

Hinweise

Verwenden Sie diese Methode zum Erstellen oder öffnen eine Datei mit zugewiesenem Speicher, die nicht persistent gespeichert wird (d. h. keine Datei auf dem Datenträger zugeordnet), die Sie zum Freigeben von Daten zwischen Prozessen verwenden können.Use this method to create or open a memory-mapped file that is not persisted (that is, not associated with a file on disk), which you can use to share data between processes.

Siehe auch

Gilt für: