MemoryMappedFile.CreateViewStream Метод

Определение

Пространство имен:

System.IO.MemoryMappedFiles

Сборка:

System.IO.MemoryMappedFiles.dll

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

Перегрузки

CreateViewStream()	Создает поток, который соответствует представлению размещенного в памяти файла.
CreateViewStream(Int64, Int64)	Создает поток, который сопоставляется с представлением размещенного в памяти файла и имеет заданное смещение и размер.
CreateViewStream(Int64, Int64, MemoryMappedFileAccess)	Создает поток, который сопоставляется с представлением размещенного в памяти файла и имеет заданное смещение, размер и тип доступа.

CreateViewStream()

Исходный код:

MemoryMappedFile.cs

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

public:
 System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream();

public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream ();

member this.CreateViewStream : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewStream

Public Function CreateViewStream () As MemoryMappedViewStream

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

MemoryMappedViewStream

Поток памяти.

Исключения

UnauthorizedAccessException

Доступ к сопоставленному в памяти файлу не авторизован.

Примеры

В следующем примере создается поток и записывается значение в него. Этот пример кода является частью более крупного примера, предоставленного 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

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

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.MemoryMappedViewStream

Public Function CreateViewStream (offset As Long, size As Long) As MemoryMappedViewStream

Параметры

offset

Int64

Байт, с которого должно начинаться представление.

size

Int64

Размер представления. Укажите 0 (нуль), чтобы создать представление, которое начинается с offset и заканчивается приблизительно в конце размещенного в памяти файла.

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

MemoryMappedViewStream

Поток памяти с заданными смещением и размером.

Исключения

ArgumentOutOfRangeException

offset или size является отрицательным значением.

-или-

size больше логического адресного пространства.

UnauthorizedAccessException

Доступ к сопоставленному в памяти файлу не авторизован.

IOException

size больше, чем общая виртуальная память.

Комментарии

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

Чтобы создать полное представление файла, сопоставленного с памятью, укажите 0 (ноль) для size параметра . В этом случае размер представления может быть больше размера исходного файла на диске. Это связано с тем, что представления предоставляются в единицах системных страниц, а размер представления округляется до следующего размера системной страницы.

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

• Файлы, сопоставленные в памяти

CreateViewStream(Int64, Int64, MemoryMappedFileAccess)

Исходный код:

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);

member this.CreateViewStream : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewStream

Public Function CreateViewStream (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewStream

Параметры

offset

Int64

Байт, с которого должно начинаться представление.

size

Int64

Размер представления. Укажите 0 (нуль), чтобы создать представление, которое начинается с offset и заканчивается приблизительно в конце размещенного в памяти файла.

access

MemoryMappedFileAccess

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

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

MemoryMappedViewStream

Поток памяти с заданными характеристиками.

Исключения

ArgumentOutOfRangeException

offset или size является отрицательным значением.

-или-

size больше логического адресного пространства.

-или-

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

UnauthorizedAccessException

Параметр access недопустим для сопоставленного в памяти файла.

IOException

size больше, чем общая виртуальная память.

-или-

Параметр access недопустим для сопоставленного в памяти файла.

Комментарии

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

Чтобы создать полное представление файла, сопоставленного с памятью, укажите 0 (ноль) для size параметра . В этом случае размер представления может быть больше размера исходного файла на диске. Это связано с тем, что представления предоставляются в единицах системных страниц, а размер представления округляется до следующего размера системной страницы.

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

• Файлы, сопоставленные в памяти