MemoryMappedFile.CreateViewStream Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает поток, который соответствует представлению размещенного в памяти файла.
Перегрузки
| CreateViewStream() |
Создает поток, который соответствует представлению размещенного в памяти файла. |
| CreateViewStream(Int64, Int64) |
Создает поток, который сопоставляется с представлением размещенного в памяти файла и имеет заданное смещение и размер. |
| CreateViewStream(Int64, Int64, MemoryMappedFileAccess) |
Создает поток, который сопоставляется с представлением размещенного в памяти файла и имеет заданное смещение, размер и тип доступа. |
CreateViewStream()
- Исходный код:
- MemoryMappedFile.cs
- Исходный код:
- MemoryMappedFile.cs
- Исходный код:
- MemoryMappedFile.cs
Создает поток, который соответствует представлению размещенного в памяти файла.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream();public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream ();member this.CreateViewStream : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewStreamPublic Function CreateViewStream () As MemoryMappedViewStreamВозвращаемое значение
Поток памяти.
Исключения
Доступ к сопоставленному в памяти файлу не авторизован.
Примеры
В следующем примере создается поток и записывается значение в него. Этот пример кода является частью более крупного примера, предоставленного CreateNew для метода .
using (MemoryMappedViewStream stream = mmf.CreateViewStream())
{
BinaryWriter writer = new BinaryWriter(stream);
writer.Write(1);
}
Using Stream As MemoryMappedViewStream = mmf.CreateViewStream()
Dim writer As BinaryWriter = New BinaryWriter(Stream)
writer.Write(1)
End Using
Комментарии
Вы можете использовать поток, возвращаемый этим методом, для последовательного доступа к файлу, сопоставленного в памяти, например для межпроцессного взаимодействия.
См. также раздел
Применяется к
CreateViewStream(Int64, Int64)
- Исходный код:
- MemoryMappedFile.cs
- Исходный код:
- MemoryMappedFile.cs
- Исходный код:
- MemoryMappedFile.cs
Создает поток, который сопоставляется с представлением размещенного в памяти файла и имеет заданное смещение и размер.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream(long offset, long size);public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream (long offset, long size);member this.CreateViewStream : int64 * int64 -> System.IO.MemoryMappedFiles.MemoryMappedViewStreamPublic Function CreateViewStream (offset As Long, size As Long) As MemoryMappedViewStreamПараметры
- offset
- Int64
Байт, с которого должно начинаться представление.
- size
- Int64
Размер представления. Укажите 0 (нуль), чтобы создать представление, которое начинается с offset и заканчивается приблизительно в конце размещенного в памяти файла.
Возвращаемое значение
Поток памяти с заданными смещением и размером.
Исключения
offset или size является отрицательным значением.
-или-
size больше логического адресного пространства.
Доступ к сопоставленному в памяти файлу не авторизован.
size больше, чем общая виртуальная память.
Комментарии
Вы можете использовать поток, возвращаемый этим методом, для последовательного доступа к файлу, сопоставленного в памяти, например для межпроцессного взаимодействия.
Чтобы создать полное представление сопоставленного в памяти файла, укажите 0 (ноль) для size параметра . В этом случае размер представления может быть больше размера исходного файла на диске. Это связано с тем, что представления предоставляются в единицах системных страниц, а размер представления округляется до следующего размера системной страницы.
См. также раздел
Применяется к
CreateViewStream(Int64, Int64, MemoryMappedFileAccess)
- Исходный код:
- MemoryMappedFile.cs
- Исходный код:
- MemoryMappedFile.cs
- Исходный код:
- MemoryMappedFile.cs
Создает поток, который сопоставляется с представлением размещенного в памяти файла и имеет заданное смещение, размер и тип доступа.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream(long offset, long size, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access);public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream (long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);[System.Security.SecurityCritical]
public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream (long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);member this.CreateViewStream : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewStream[<System.Security.SecurityCritical>]
member this.CreateViewStream : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewStreamPublic Function CreateViewStream (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewStreamПараметры
- offset
- Int64
Байт, с которого должно начинаться представление.
- size
- Int64
Размер представления. Укажите 0 (нуль), чтобы создать представление, которое начинается с offset и заканчивается приблизительно в конце размещенного в памяти файла.
- access
- MemoryMappedFileAccess
Одно из значений перечисления, определяющее разрешенный тип доступа к размещенному в памяти файлу. Значение по умолчанию — ReadWrite.
Возвращаемое значение
Поток памяти с заданными характеристиками.
- Атрибуты
Исключения
offset или size является отрицательным значением.
-или-
size больше логического адресного пространства.
-или-
access не является допустимым значением перечисления MemoryMappedFileAccess.
Параметр access недопустим для сопоставленного в памяти файла.
size больше, чем общая виртуальная память.
-или-
Параметр access недопустим для сопоставленного в памяти файла.
Комментарии
Вы можете использовать поток, возвращаемый этим методом, для последовательного доступа к файлу, сопоставленного в памяти, например для межпроцессного взаимодействия.
Чтобы создать полное представление сопоставленного в памяти файла, укажите 0 (ноль) для size параметра . В этом случае размер представления может быть больше размера исходного файла на диске. Это связано с тем, что представления предоставляются в единицах системных страниц, а размер представления округляется до следующего размера системной страницы.
