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