MemoryMappedFile.CreateViewAccessor Metode

Definisi

Ruang nama:

System.IO.MemoryMappedFiles

Rakitan:

System.IO.MemoryMappedFiles.dll

MemoryMappedViewAccessor Membuat yang memetakan ke tampilan file yang dipetakan memori.

Overload

CreateViewAccessor()	MemoryMappedViewAccessor Membuat yang memetakan ke tampilan file yang dipetakan memori.
CreateViewAccessor(Int64, Int64)	MemoryMappedViewAccessor Membuat yang memetakan ke tampilan file yang dipetakan memori, dan yang memiliki offset dan ukuran yang ditentukan.
CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)	MemoryMappedViewAccessor Membuat yang memetakan ke tampilan file yang dipetakan memori, dan yang memiliki pembatasan offset, ukuran, dan akses yang ditentukan.

CreateViewAccessor()

Sumber:

MemoryMappedFile.cs

MemoryMappedViewAccessor Membuat yang memetakan ke tampilan file yang dipetakan memori.

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

Mengembalikan

MemoryMappedViewAccessor

Blok memori yang dapat diakses secara acak.

Pengecualian

UnauthorizedAccessException

Akses ke file yang dipetakan memori tidak sah.

Keterangan

Anda dapat menggunakan tampilan yang dikembalikan oleh metode ini untuk akses acak ke file yang dipetakan memori.

Lihat juga

• File yang Dipetakan Memori

CreateViewAccessor(Int64, Int64)

Sumber:

MemoryMappedFile.cs

MemoryMappedViewAccessor Membuat yang memetakan ke tampilan file yang dipetakan memori, dan yang memiliki offset dan ukuran yang ditentukan.

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

Parameter

offset

Int64

Byte untuk memulai tampilan.

size

Int64

Ukuran tampilan. Tentukan 0 (nol) untuk membuat tampilan yang dimulai pada dan berakhir kira-kira di akhir file yang dipetakan offset memori.

Mengembalikan

MemoryMappedViewAccessor

Blok memori yang dapat diakses secara acak.

Pengecualian

ArgumentOutOfRangeException

offset atau size adalah nilai negatif.

-atau-

size lebih besar dari ruang alamat logis.

UnauthorizedAccessException

Akses ke file yang dipetakan memori tidak sah.

IOException

Terjadi kesalahan I/O.

Contoh

Contoh berikut membuat tampilan file yang dipetakan memori dan mengeditnya. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk MemoryMappedFile kelas .

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

Keterangan

Anda dapat menggunakan tampilan yang dikembalikan oleh metode ini untuk akses acak ke file yang dipetakan memori.

Untuk membuat tampilan lengkap file yang dipetakan memori, tentukan 0 (nol) untuk size parameter . Jika Anda melakukan ini, ukuran tampilan mungkin lebih besar dari ukuran file sumber pada disk. Ini karena tampilan disediakan dalam satuan halaman sistem, dan ukuran tampilan dibulatkan ke ukuran halaman sistem berikutnya.

Lihat juga

• File yang Dipetakan Memori

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Sumber:

MemoryMappedFile.cs

MemoryMappedViewAccessor Membuat yang memetakan ke tampilan file yang dipetakan memori, dan yang memiliki pembatasan offset, ukuran, dan akses yang ditentukan.

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

Parameter

offset

Int64

Byte untuk memulai tampilan.

size

Int64

Ukuran tampilan. Tentukan 0 (nol) untuk membuat tampilan yang dimulai pada dan berakhir kira-kira di akhir file yang dipetakan offset memori.

access

MemoryMappedFileAccess

Salah satu nilai enumerasi yang menentukan jenis akses yang diizinkan ke file yang dipetakan memori. Default adalah ReadWrite.

Mengembalikan

MemoryMappedViewAccessor

Blok memori yang dapat diakses secara acak.

Pengecualian

ArgumentOutOfRangeException

offset atau size adalah nilai negatif.

-atau-

size lebih besar dari ruang alamat logis.

UnauthorizedAccessException

access tidak valid untuk file yang dipetakan memori.

IOException

Terjadi kesalahan I/O.

Keterangan

Anda dapat menggunakan tampilan yang dikembalikan oleh metode ini untuk akses acak ke file yang dipetakan memori.

Untuk membuat tampilan lengkap file yang dipetakan memori, tentukan 0 (nol) untuk size parameter . Jika Anda melakukan ini, ukuran tampilan mungkin lebih besar dari ukuran file sumber pada disk. Ini karena tampilan disediakan dalam satuan halaman sistem, dan ukuran tampilan dibulatkan ke ukuran halaman sistem berikutnya.

Lihat juga

• File yang Dipetakan Memori