MemoryMappedFile.CreateViewAccessor Metoda

Definicja

Przestrzeń nazw:

System.IO.MemoryMappedFiles

Zestaw:

System.IO.MemoryMappedFiles.dll

Tworzy obiekt MemoryMappedViewAccessor , który jest mapowany na widok pliku mapowanego na pamięć.

Przeciążenia

CreateViewAccessor()	Tworzy obiekt MemoryMappedViewAccessor , który jest mapowany na widok pliku mapowanego na pamięć.
CreateViewAccessor(Int64, Int64)	Tworzy obiekt MemoryMappedViewAccessor , który jest mapowany na widok pliku mapowanego na pamięć i który ma określone przesunięcie i rozmiar.
CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)	Tworzy obiekt MemoryMappedViewAccessor , który jest mapowany na widok pliku mapowanego na pamięć i ma określone przesunięcie, rozmiar i ograniczenia dostępu.

CreateViewAccessor()

Źródło:

MemoryMappedFile.cs

Tworzy obiekt MemoryMappedViewAccessor , który jest mapowany na widok pliku mapowanego na pamięć.

public:
 System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor();

public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor ();

member this.CreateViewAccessor : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor

Public Function CreateViewAccessor () As MemoryMappedViewAccessor

Zwraca

MemoryMappedViewAccessor

Losowo dostępny blok pamięci.

Wyjątki

UnauthorizedAccessException

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

Uwagi

Widok zwrócony przez tę metodę umożliwia losowy dostęp do pliku zamapowanego na pamięć.

Zobacz też

• Pliki mapowane na pamięć

CreateViewAccessor(Int64, Int64)

Źródło:

MemoryMappedFile.cs

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

public:
 System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor(long offset, long size);

public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor (long offset, long size);

member this.CreateViewAccessor : int64 * int64 -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor

Public Function CreateViewAccessor (offset As Long, size As Long) As MemoryMappedViewAccessor

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 zamapowanego na pamięć.

Zwraca

MemoryMappedViewAccessor

Losowo dostępny blok pamięci.

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

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład tworzy widok pliku mapowanego w pamięci i edytuje go. Ten przykład kodu jest częścią większego przykładu udostępnionego MemoryMappedFile dla klasy .

// Create a random access view, from the 256th megabyte (the offset)
// to the 768th megabyte (the offset plus length).
using (var accessor = mmf.CreateViewAccessor(offset, length))
{
    int colorSize = Marshal.SizeOf(typeof(MyColor));
    MyColor color;

    // Make changes to the view.
    for (long i = 0; i < length; i += colorSize)
    {
        accessor.Read(i, out color);
        color.Brighten(10);
        accessor.Write(i, ref color);
    }
}

' Create a random access view, from the 256th megabyte (the offset)
' to the 768th megabyte (the offset plus length).
Using accessor = mmf.CreateViewAccessor(offset, length)
    Dim colorSize As Integer = Marshal.SizeOf(GetType(MyColor))
    Dim color As MyColor
    Dim i As Long = 0

    ' Make changes to the view.
    Do While (i < length)
        accessor.Read(i, color)
        color.Brighten(10)
        accessor.Write(i, color)
        i += colorSize
    Loop
End Using

Uwagi

Widok zwrócony przez tę metodę umożliwia losowy dostęp do pliku zamapowanego na pamięć.

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 na pamięć

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Źródło:

MemoryMappedFile.cs

Tworzy obiekt MemoryMappedViewAccessor , który jest mapowany na widok pliku mapowanego na pamięć i ma określone przesunięcie, rozmiar i ograniczenia dostępu.

public:
 System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor(long offset, long size, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access);

public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor (long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);

member this.CreateViewAccessor : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor

Public Function CreateViewAccessor (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewAccessor

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 zamapowanego 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

MemoryMappedViewAccessor

Losowo dostępny blok pamięci.

Wyjątki

ArgumentOutOfRangeException

offset lub size jest wartością ujemną.

-lub-

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

UnauthorizedAccessException

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

IOException

Wystąpił błąd we/wy.

Uwagi

Widok zwrócony przez tę metodę umożliwia losowy dostęp do pliku zamapowanego na pamięć.

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 na pamięć