MemoryMappedFile.CreateViewAccessor Metoda

Definice

Vytvoří MemoryMappedViewAccessor, který se mapuje na zobrazení souboru mapovaného do paměti.Creates a MemoryMappedViewAccessor that maps to a view of the memory-mapped file.

Přetížení

CreateViewAccessor()

Vytvoří MemoryMappedViewAccessor, který se mapuje na zobrazení souboru mapovaného do paměti.Creates a MemoryMappedViewAccessor that maps to a view of the memory-mapped file.

CreateViewAccessor(Int64, Int64)

Vytvoří MemoryMappedViewAccessor, který se mapuje na zobrazení souboru mapované paměti a má zadaný posun a velikost.Creates a MemoryMappedViewAccessor that maps to a view of the memory-mapped file, and that has the specified offset and size.

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Vytvoří MemoryMappedViewAccessor, který se mapuje na zobrazení souboru mapované paměti a má nastavené omezení posunu, velikosti a přístupu.Creates a MemoryMappedViewAccessor that maps to a view of the memory-mapped file, and that has the specified offset, size, and access restrictions.

CreateViewAccessor()

Vytvoří MemoryMappedViewAccessor, který se mapuje na zobrazení souboru mapovaného do paměti.Creates a MemoryMappedViewAccessor that maps to a view of the memory-mapped file.

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

Návraty

MemoryMappedViewAccessor

Náhodně přístupný blok paměti.A randomly accessible block of memory.

Výjimky

Přístup k souboru mapované paměti je neautorizovaný.Access to the memory-mapped file is unauthorized.

Poznámky

Můžete použít zobrazení vrácené touto metodou pro náhodný přístup k souboru mapované paměti.You can use the view returned by this method for random access to a memory-mapped file.

Viz také

CreateViewAccessor(Int64, Int64)

Vytvoří MemoryMappedViewAccessor, který se mapuje na zobrazení souboru mapované paměti a má zadaný posun a velikost.Creates a MemoryMappedViewAccessor that maps to a view of the memory-mapped file, and that has the specified offset and size.

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, ve kterém se má zobrazení spustitThe byte at which to start the view.

size
Int64

Velikost zobrazeníThe size of the view. Chcete-li vytvořit zobrazení, které začíná na offset a končí přibližně na konci souboru mapovaného paměti, zadejte 0 (nula).Specify 0 (zero) to create a view that starts at offset and ends approximately at the end of the memory-mapped file.

Návraty

MemoryMappedViewAccessor

Náhodně přístupný blok paměti.A randomly accessible block of memory.

Výjimky

offset nebo size je záporná hodnota.offset or size is a negative value.

-nebo--or- size je větší než logický adresní prostor.size is greater than the logical address space.

Přístup k souboru mapované paměti je neautorizovaný.Access to the memory-mapped file is unauthorized.

Došlo k vstupně-výstupní chybě.An I/O error occurred.

Příklady

Následující příklad vytvoří zobrazení souboru mapované paměti a upraví ho.The following example creates a view of a memory-mapped file and edits it. Tato ukázka kódu je součástí většího příkladu vztahujícího se ke třídě MemoryMappedFile.This code example is part of a larger example provided for the MemoryMappedFile class.

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

Poznámky

Můžete použít zobrazení vrácené touto metodou pro náhodný přístup k souboru mapované paměti.You can use the view returned by this method for random access to a memory-mapped file.

Chcete-li vytvořit úplné zobrazení souboru mapované paměti, zadejte hodnotu 0 (nula) pro parametr size.To create a complete view of the memory-mapped file, specify 0 (zero) for the size parameter. Pokud to uděláte, může být velikost zobrazení menší nebo větší než velikost zdrojového souboru na disku.If you do this, the size of the view might be smaller or larger than the size of the source file on disk. Je to proto, že zobrazení jsou k dispozici v jednotkách systémových stránek a velikost zobrazení se zaokrouhluje na další velikost stránky systému.This is because views are provided in units of system pages, and the size of the view is rounded up to the next system page size.

Viz také

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Vytvoří MemoryMappedViewAccessor, který se mapuje na zobrazení souboru mapované paměti a má nastavené omezení posunu, velikosti a přístupu.Creates a MemoryMappedViewAccessor that maps to a view of the memory-mapped file, and that has the specified offset, size, and access restrictions.

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
Public Function CreateViewAccessor (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewAccessor

Parametry

offset
Int64

Bajt, ve kterém se má zobrazení spustitThe byte at which to start the view.

size
Int64

Velikost zobrazeníThe size of the view. Chcete-li vytvořit zobrazení, které začíná na offset a končí přibližně na konci souboru mapovaného paměti, zadejte 0 (nula).Specify 0 (zero) to create a view that starts at offset and ends approximately at the end of the memory-mapped file.

access
MemoryMappedFileAccess

Jedna z hodnot výčtu, která určuje typ přístupu, který je povolený pro soubor mapované paměti.One of the enumeration values that specifies the type of access allowed to the memory-mapped file. Výchozí formát je ReadWrite.The default is ReadWrite.

Návraty

MemoryMappedViewAccessor

Náhodně přístupný blok paměti.A randomly accessible block of memory.

Atributy

Výjimky

offset nebo size je záporná hodnota.offset or size is a negative value.

-nebo--or- size je větší než logický adresní prostor.size is greater than the logical address space.

access je pro soubor mapované paměti neplatné.access is invalid for the memory-mapped file.

Došlo k vstupně-výstupní chybě.An I/O error occurred.

Poznámky

Můžete použít zobrazení vrácené touto metodou pro náhodný přístup k souboru mapované paměti.You can use the view returned by this method for random access to a memory-mapped file.

Chcete-li vytvořit úplné zobrazení souboru mapované paměti, zadejte hodnotu 0 (nula) pro parametr size.To create a complete view of the memory-mapped file, specify 0 (zero) for the size parameter. Pokud to uděláte, může být velikost zobrazení menší nebo větší než velikost zdrojového souboru na disku.If you do this, the size of the view might be smaller or larger than the size of the source file on disk. Je to proto, že zobrazení jsou k dispozici v jednotkách systémových stránek a velikost zobrazení se zaokrouhluje na další velikost stránky systému.This is because views are provided in units of system pages, and the size of the view is rounded up to the next system page size.

Viz také

Platí pro