Udostępnij za pośrednictwem


MemoryMappedFile.CreateViewAccessor Metoda

Definicja

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
Źródło:
MemoryMappedFile.cs
Ź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

Losowo dostępny blok pamięci.

Wyjątki

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ż

Dotyczy

CreateViewAccessor(Int64, Int64)

Źródło:
MemoryMappedFile.cs
Źródło:
MemoryMappedFile.cs
Ź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 mapowanego na pamięć.

Zwraca

Losowo dostępny blok pamięci.

Wyjątki

offset lub size jest wartością ujemną.

-lub-

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

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

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ż

Dotyczy

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Źródło:
MemoryMappedFile.cs
Źródło:
MemoryMappedFile.cs
Ź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);
[System.Security.SecurityCritical]
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
[<System.Security.SecurityCritical>]
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 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

Losowo dostępny blok pamięci.

Atrybuty

Wyjątki

offset lub size jest wartością ujemną.

-lub-

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

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

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ż

Dotyczy