MemoryMappedFile.CreateViewStream Metoda

Definicja

Przestrzeń nazw:

System.IO.MemoryMappedFiles

Zestaw:

System.IO.MemoryMappedFiles.dll

Tworzy strumień mapowany na widok pliku mapowanego na pamięć.

Przeciążenia

CreateViewStream()	Tworzy strumień mapowany na widok pliku mapowanego na pamięć.
CreateViewStream(Int64, Int64)	Tworzy strumień, który jest mapowany na widok pliku mapowanego na pamięć i który ma określone przesunięcie i rozmiar.
CreateViewStream(Int64, Int64, MemoryMappedFileAccess)	Tworzy strumień, który jest mapowany na widok pliku mapowanego na pamięć i ma określony typ przesunięcia, rozmiaru i dostępu.

CreateViewStream()

Źródło:

MemoryMappedFile.cs

Tworzy strumień mapowany na widok pliku mapowanego na pamięć.

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

Zwraca

MemoryMappedViewStream

Strumień pamięci.

Wyjątki

UnauthorizedAccessException

Dostęp do pliku mapowanego na pamięć jest nieautoryzowany.

Przykłady

Poniższy przykład tworzy strumień i zapisuje w nim wartość. Ten przykład kodu jest częścią większego przykładu udostępnionego CreateNew dla metody .

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

Uwagi

Strumienia zwróconego przez tę metodę można użyć do sekwencyjnego dostępu do pliku zamapowanego na pamięć, takiego jak w przypadku komunikacji między procesami.

Zobacz też

• Pliki mapowane w pamięci

CreateViewStream(Int64, Int64)

Źródło:

MemoryMappedFile.cs

Tworzy strumień, który jest mapowany na widok pliku mapowanego na pamięć i który ma określone przesunięcie i rozmiar.

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

Parametry

offset

Int64

Bajt, w którym ma być uruchomiony widok.

size

Int64

Rozmiar widoku. Określ wartość 0 (zero), aby utworzyć widok rozpoczynający się od offset i kończący się w przybliżeniu na końcu pliku mapowanego na pamięć.

Zwraca

MemoryMappedViewStream

Strumień pamięci z określonym przesunięciem i rozmiarem.

Wyjątki

ArgumentOutOfRangeException

offset lub size jest wartością ujemną.

-lub-

size jest większa niż przestrzeń adresowa logiczna.

UnauthorizedAccessException

Dostęp do pliku mapowanego na pamięć jest nieautoryzowany.

IOException

size jest większa niż całkowita pamięć wirtualna.

Uwagi

Strumienia zwróconego przez tę metodę można użyć do sekwencyjnego dostępu do pliku zamapowanego na pamięć, takiego jak w przypadku komunikacji między procesami.

Aby utworzyć pełny widok pliku mapowanego na pamięć, określ wartość 0 (zero) dla parametru size . W takim przypadku rozmiar widoku może być większy niż rozmiar pliku źródłowego na dysku. Wynika to z tego, że widoki są udostępniane w jednostkach stron systemowych, a rozmiar widoku jest zaokrąglany do następnego rozmiaru strony systemowej.

Zobacz też

• Pliki mapowane w pamięci

CreateViewStream(Int64, Int64, MemoryMappedFileAccess)

Źródło:

MemoryMappedFile.cs

Tworzy strumień, który jest mapowany na widok pliku mapowanego na pamięć i ma określony typ przesunięcia, rozmiaru i dostępu.

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

Parametry

offset

Int64

Bajt, w którym ma być uruchomiony widok.

size

Int64

Rozmiar widoku. Określ wartość 0 (zero), aby utworzyć widok rozpoczynający się od offset i kończący się w przybliżeniu na końcu pliku mapowanego na pamięć.

access

MemoryMappedFileAccess

Jedna z wartości wyliczenia określająca typ dostępu dozwolonego do pliku mapowanego w pamięci. Wartość domyślna to ReadWrite.

Zwraca

MemoryMappedViewStream

Strumień pamięci, który ma określoną charakterystykę.

Wyjątki

ArgumentOutOfRangeException

offset lub size jest wartością ujemną.

-lub-

size jest większa niż przestrzeń adresowa logiczna.

-lub-

access nie jest prawidłową MemoryMappedFileAccess wartością wyliczenia.

UnauthorizedAccessException

access jest nieprawidłowy dla pliku zamapowanego na pamięć.

IOException

size jest większa niż całkowita pamięć wirtualna.

-lub-

access jest nieprawidłowy dla pliku zamapowanego na pamięć.

Uwagi

Strumienia zwróconego przez tę metodę można użyć do sekwencyjnego dostępu do pliku zamapowanego na pamięć, takiego jak w przypadku komunikacji między procesami.

Aby utworzyć pełny widok pliku mapowanego na pamięć, określ wartość 0 (zero) dla parametru size . W takim przypadku rozmiar widoku może być większy niż rozmiar pliku źródłowego na dysku. Wynika to z tego, że widoki są udostępniane w jednostkach stron systemowych, a rozmiar widoku jest zaokrąglany do następnego rozmiaru strony systemowej.

Zobacz też

• Pliki mapowane w pamięci