Поделиться через


MemoryMappedFile.CreateOrOpen Метод

Определение

Создает или открывает размещенный в памяти файл в системной памяти.

Перегрузки

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)

Создает или открывает отображенный в память файл с заданным именем, емкостью, типом доступа, выделением памяти, разрешениями безопасности и режимом наследования в системной памяти.

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)

Создает пустой отображенный в память файл или открывает существующий отображенный в память файл, если он уже существует с таким же именем. При открытии существующего файла емкость, параметры и аргументы памяти игнорируются.

CreateOrOpen(String, Int64)

Создает или открывает отображенный в память файл с заданным именем и емкостью в системной памяти.

CreateOrOpen(String, Int64, MemoryMappedFileAccess)

Создает или открывает отображенный в память файл с заданным именем, емкостью и типом доступа в системной памяти.

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)

Создает или открывает отображенный в память файл с заданным именем, емкостью, типом доступа, выделением памяти, разрешениями безопасности и режимом наследования в системной памяти.

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

Параметры

mapName
String

Имя отображенного в память файла.

capacity
Int64

Максимальный размер, выделяемый размещенному в памяти файлу, в байтах.

access
MemoryMappedFileAccess

Одно из значений перечисления, определяющее разрешенный тип доступа к размещенному в памяти файлу. Значение по умолчанию — ReadWrite.

options
MemoryMappedFileOptions

Побитовое сочетание значений перечисления, которое задает параметры выделения памяти для размещенного в памяти файла.

memoryMappedFileSecurity
MemoryMappedFileSecurity

Разрешения, которые могут быть предоставлены для доступа к файлам и операций с размещенными в памяти файлами.

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

inheritability
HandleInheritability

Одно из значений перечисления, определяющее, может ли дескриптор размещенного в памяти файла наследоваться дочерним процессом. Значение по умолчанию — None.

Возвращаемое значение

Размещенный в памяти файл с заданными характеристиками.

Атрибуты

Исключения

mapName имеет значение null.

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

-или-

Параметр access задан как доступный только для записи с помощью значения перечисления Write.

capacity больше, чем размер логического адресного пространства.

-или-

capacity меньше или равно нулю.

-или-

access не является допустимым значением перечисления MemoryMappedFileAccess.

-или-

inheritability не является допустимым значением перечисления HandleInheritability.

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

Комментарии

Используйте этот метод для создания или открытия файла, сопоставленного в памяти, который не сохраняется (т. е. не связан с файлом на диске), который можно использовать для совместного использования данных между процессами.

См. также раздел

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

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)

Исходный код:
MemoryMappedFile.cs
Исходный код:
MemoryMappedFile.cs
Исходный код:
MemoryMappedFile.cs

Создает пустой отображенный в память файл или открывает существующий отображенный в память файл, если он уже существует с таким же именем. При открытии существующего файла емкость, параметры и аргументы памяти игнорируются.

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

Параметры

mapName
String

Имя отображенного в память файла.

capacity
Int64

Максимальный размер, выделяемый размещенному в памяти файлу, в байтах.

access
MemoryMappedFileAccess

Одно из значений перечисления, определяющее разрешенный тип доступа к размещенному в памяти файлу. Значение по умолчанию — ReadWrite.

options
MemoryMappedFileOptions

Битовая комбинация значений, которая указывает параметры выделения памяти, применяемые к файлу.

inheritability
HandleInheritability

Значение, которое указывает, может ли дескриптор отображенного в память файла наследоваться дочерним процессом. Значение по умолчанию — None.

Возвращаемое значение

Размещенный в памяти файл с заданными характеристиками.

Атрибуты

Исключения

mapName имеет значение null.

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

-или-

Параметр access задан как доступный только для записи с помощью значения перечисления Write.

capacity больше, чем размер логического адресного пространства.

-или-

capacity меньше или равно нулю.

-или-

access не является допустимым значением перечисления MemoryMappedFileAccess.

-или-

inheritability не является допустимым значением перечисления HandleInheritability.

В операционной системе запрещен указанный доступ к файлу; например, доступ установлен как Write или ReadWrite, но файл или каталог доступен только для чтения.

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

CreateOrOpen(String, Int64)

Исходный код:
MemoryMappedFile.cs
Исходный код:
MemoryMappedFile.cs
Исходный код:
MemoryMappedFile.cs

Создает или открывает отображенный в память файл с заданным именем и емкостью в системной памяти.

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

Параметры

mapName
String

Имя отображенного в память файла.

capacity
Int64

Максимальный размер, выделяемый размещенному в памяти файлу, в байтах.

Возвращаемое значение

Размещенный в памяти файл с заданным именем и размером.

Атрибуты

Исключения

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

capacity больше, чем размер логического адресного пространства.

-или-

capacity меньше или равно нулю.

Комментарии

Используйте этот метод для создания или открытия файла, сопоставленного в памяти, который не сохраняется (т. е. не связан с файлом на диске), который можно использовать для совместного использования данных между процессами.

См. также раздел

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

CreateOrOpen(String, Int64, MemoryMappedFileAccess)

Исходный код:
MemoryMappedFile.cs
Исходный код:
MemoryMappedFile.cs
Исходный код:
MemoryMappedFile.cs

Создает или открывает отображенный в память файл с заданным именем, емкостью и типом доступа в системной памяти.

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

Параметры

mapName
String

Имя отображенного в память файла.

capacity
Int64

Максимальный размер, выделяемый размещенному в памяти файлу, в байтах.

access
MemoryMappedFileAccess

Одно из значений перечисления, определяющее разрешенный тип доступа к размещенному в памяти файлу. Значение по умолчанию — ReadWrite.

Возвращаемое значение

Размещенный в памяти файл с заданными характеристиками.

Атрибуты

Исключения

mapName имеет значение null.

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

-или-

Параметр access задан как доступный только для записи с помощью значения перечисления Write.

capacity больше, чем размер логического адресного пространства.

-или-

capacity меньше или равно нулю.

-или-

access не является допустимым значением перечисления MemoryMappedFileAccess.

В операционной системе запрещен указанный доступ к файлу; например, доступ установлен как Write или ReadWrite, но файл или каталог доступен только для чтения.

Комментарии

Используйте этот метод для создания или открытия файла, сопоставленного в памяти, который не сохраняется (т. е. не связан с файлом на диске), который можно использовать для совместного использования данных между процессами.

См. также раздел

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