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

Определение

Создает или открывает размещенный в памяти файл в системной памяти.Creates or opens a memory-mapped file 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)

Создает пустой отображенный в память файл или открывает существующий отображенный в память файл, если он уже существует с таким же именем.Creates a new empty memory mapped file or opens an existing memory mapped file if one exists with the same name. При открытии существующего файла емкость, параметры и аргументы памяти игнорируются.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)

Создает или открывает отображенный в память файл с заданным именем, емкостью, типом доступа, выделением памяти, разрешениями безопасности и режимом наследования в системной памяти.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)

Создает или открывает отображенный в память файл с заданным именем и емкостью в системной памяти.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)

Создает или открывает отображенный в память файл с заданным именем, емкостью и типом доступа в системной памяти.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)

Создает пустой отображенный в память файл или открывает существующий отображенный в память файл, если он уже существует с таким же именем.Creates a new empty memory mapped file or opens an existing memory mapped file if one exists with the same name. При открытии существующего файла емкость, параметры и аргументы памяти игнорируются.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

Параметры

mapName
String String String String

Имя отображенного в память файла.The name of the memory-mapped file.

capacity
Int64 Int64 Int64 Int64

Максимальный размер, выделяемый размещенному в памяти файлу, в байтах.The maximum size, in bytes, to allocate to the memory-mapped file.

access
MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess

Одно из значений перечисления, определяющее разрешенный тип доступа к размещенному в памяти файлу.One of the enumeration values that specifies the type of access allowed to the memory-mapped file. Значение по умолчанию — ReadWrite.The default is ReadWrite.

options
MemoryMappedFileOptions MemoryMappedFileOptions MemoryMappedFileOptions MemoryMappedFileOptions

Битовая комбинация значений, которая указывает параметры выделения памяти, применяемые к файлу.A bitwise combination of values that indicate the memory allocation options to apply to the file.

inheritability
HandleInheritability HandleInheritability HandleInheritability HandleInheritability

Значение, которое указывает, может ли дескриптор отображенного в память файла наследоваться дочерним процессом.A value that specifies whether a handle to the memory-mapped file can be inherited by a child process. Значение по умолчанию — None.The default is None.

Возвраты

Размещенный в памяти файл с заданными характеристиками.A memory-mapped file that has the specified characteristics.

Исключения

Свойство mapName имеет значение null.mapName is null.

Параметр mapName равен пустой строке.mapName is an empty string.

-или--or- Параметр access задан как доступный только для записи с помощью значения перечисления Write.access is set to write-only with the Write enumeration value.

capacity больше, чем размер логического адресного пространства.capacity is greater than the size of the logical address space.

- или --or- Значение capacity не больше нуля.capacity is less than or equal to zero.

-или--or- access не является допустимым значением перечисления MemoryMappedFileAccess.access is not a valid MemoryMappedFileAccess enumeration value.

-или--or- inheritability не является допустимым значением перечисления HandleInheritability.inheritability is not a valid HandleInheritability enumeration value.

В операционной системе запрещен указанный доступ к файлу; например, доступ установлен как Write или ReadWrite, но файл или каталог доступен только для чтения.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)

Создает или открывает отображенный в память файл с заданным именем, емкостью, типом доступа, выделением памяти, разрешениями безопасности и режимом наследования в системной памяти.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

Параметры

mapName
String String String String

Имя отображенного в память файла.The name of the memory-mapped file.

capacity
Int64 Int64 Int64 Int64

Максимальный размер, выделяемый размещенному в памяти файлу, в байтах.The maximum size, in bytes, to allocate to the memory-mapped file.

access
MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess

Одно из значений перечисления, определяющее разрешенный тип доступа к размещенному в памяти файлу.One of the enumeration values that specifies the type of access allowed to the memory-mapped file. Значение по умолчанию — ReadWrite.The default is ReadWrite.

options
MemoryMappedFileOptions MemoryMappedFileOptions MemoryMappedFileOptions MemoryMappedFileOptions

Побитовое сочетание значений перечисления, которое задает параметры выделения памяти для размещенного в памяти файла.A bitwise combination of enumeration values that specifies memory allocation options for the memory-mapped file.

memoryMappedFileSecurity
MemoryMappedFileSecurity MemoryMappedFileSecurity MemoryMappedFileSecurity MemoryMappedFileSecurity

Разрешения, которые могут быть предоставлены для доступа к файлам и операций с размещенными в памяти файлами.The permissions that can be granted for file access and operations on memory-mapped files.

Этот параметр может иметь значение null.This parameter can be null.

inheritability
HandleInheritability HandleInheritability HandleInheritability HandleInheritability

Одно из значений перечисления, определяющее, может ли дескриптор размещенного в памяти файла наследоваться дочерним процессом.One of the enumeration values that specifies whether a handle to the memory-mapped file can be inherited by a child process. Значение по умолчанию — None.The default is None.

Возвраты

Размещенный в памяти файл с заданными характеристиками.A memory-mapped file that has the specified characteristics.

Исключения

Свойство mapName имеет значение null.mapName is null.

Параметр mapName равен пустой строке.mapName is an empty string.

- или --or- Параметр access задан как доступный только для записи с помощью значения перечисления Write.access is set to write-only with the Write enumeration value.

capacity больше, чем размер логического адресного пространства.capacity is greater than the size of the logical address space.

- или --or- Значение capacity не больше нуля.capacity is less than or equal to zero.

-или--or- access не является допустимым значением перечисления MemoryMappedFileAccess.access is not a valid MemoryMappedFileAccess enumeration value.

-или--or- inheritability не является допустимым значением перечисления HandleInheritability.inheritability is not a valid HandleInheritability enumeration value.

В операционной системе запрещен указанный параметром access доступ к файлу; например, для access установлено значение Write или ReadWrite, но файл или каталог доступен только для чтения.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.

Комментарии

Этот метод используется для создания или открытия отображенного в память файла, который не сохраняется (то есть не связан с файлом на диске), который можно использовать для обмена данными между процессами.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.

Безопасность

SecurityPermission
для доступа к неуправляемому коду.for access to unmanaged code. Связанное перечисление: UnmanagedCode.Associated enumeration: UnmanagedCode.

Дополнительно

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

Создает или открывает отображенный в память файл с заданным именем и емкостью в системной памяти.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

Параметры

mapName
String String String String

Имя отображенного в память файла.The name of the memory-mapped file.

capacity
Int64 Int64 Int64 Int64

Максимальный размер, выделяемый размещенному в памяти файлу, в байтах.The maximum size, in bytes, to allocate to the memory-mapped file.

Возвраты

Размещенный в памяти файл с заданным именем и размером.A memory-mapped file that has the specified name and size.

Исключения

Параметр mapName равен пустой строке.mapName is an empty string.

capacity больше, чем размер логического адресного пространства.capacity is greater than the size of the logical address space.

-или--or- Значение параметра capacity меньше или равно нулю.capacity is less than or equal to zero.

Комментарии

Этот метод используется для создания или открытия отображенного в память файла, который не сохраняется (то есть не связан с файлом на диске), который можно использовать для обмена данными между процессами.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.

Дополнительно

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

Создает или открывает отображенный в память файл с заданным именем, емкостью и типом доступа в системной памяти.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

Параметры

mapName
String String String String

Имя отображенного в память файла.The name of the memory-mapped file.

capacity
Int64 Int64 Int64 Int64

Максимальный размер, выделяемый размещенному в памяти файлу, в байтах.The maximum size, in bytes, to allocate to the memory-mapped file.

access
MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess

Одно из значений перечисления, определяющее разрешенный тип доступа к размещенному в памяти файлу.One of the enumeration values that specifies the type of access allowed to the memory-mapped file. Значение по умолчанию — ReadWrite.The default is ReadWrite.

Возвраты

Размещенный в памяти файл с заданными характеристиками.A memory-mapped file that has the specified characteristics.

Исключения

Свойство mapName имеет значение null.mapName is null.

Параметр mapName равен пустой строке.mapName is an empty string.

-или--or- Параметр access задан как доступный только для записи с помощью значения перечисления Write.access is set to write-only with the Write enumeration value.

capacity больше, чем размер логического адресного пространства.capacity is greater than the size of the logical address space.

- или --or- Значение capacity не больше нуля.capacity is less than or equal to zero.

-или--or- access не является допустимым значением перечисления MemoryMappedFileAccess.access is not a valid MemoryMappedFileAccess enumeration value.

В операционной системе запрещен указанный доступ к файлу; например, доступ установлен как Write или ReadWrite, но файл или каталог доступен только для чтения.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.

Комментарии

Этот метод используется для создания или открытия отображенного в память файла, который не сохраняется (то есть не связан с файлом на диске), который можно использовать для обмена данными между процессами.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.

Дополнительно

Применяется к