MemoryMappedFile.CreateViewStream Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает поток, который сопоставляется с представлением сопоставленного с памятью файла.
Перегрузки
| Имя | Описание |
|---|---|
| CreateViewStream() |
Создает поток, который сопоставляется с представлением сопоставленного с памятью файла. |
| CreateViewStream(Int64, Int64) |
Создает поток, который сопоставляется с представлением сопоставленного с памятью файла, и имеет указанное смещение и размер. |
| CreateViewStream(Int64, Int64, MemoryMappedFileAccess) |
Создает поток, который сопоставляется с представлением сопоставленного с памятью файла, и имеет указанный тип смещения, размера и доступа. |
CreateViewStream()
- Исходный код:
- MemoryMappedFile.cs
- Исходный код:
- MemoryMappedFile.cs
- Исходный код:
- 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
- Исходный код:
- 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
- Исходный код:
- 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 параметра. Если это сделать, размер представления может быть больше размера исходного файла на диске. Это связано с тем, что представления предоставляются в единицах системных страниц, а размер представления округляется до следующего размера системной страницы.
