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.MemoryMappedFilePublic 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.MemoryMappedFilestatic member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess * System.IO.MemoryMappedFiles.MemoryMappedFileOptions * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFilePublic 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.MemoryMappedFilestatic member CreateOrOpen : string * int64 -> System.IO.MemoryMappedFiles.MemoryMappedFilePublic 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.MemoryMappedFilestatic member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedFilePublic 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, но файл или каталог доступен только для чтения.
Комментарии
Используйте этот метод для создания или открытия файла, сопоставленного в памяти, который не сохраняется (т. е. не связан с файлом на диске), который можно использовать для совместного использования данных между процессами.
См. также раздел
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по