Condividi tramite


MemoryMappedFile.CreateViewAccessor Metodo

Definizione

Crea un oggetto MemoryMappedViewAccessor mappato a una visualizzazione del file mappato alla memoria.

Overload

CreateViewAccessor()

Crea un oggetto MemoryMappedViewAccessor mappato a una visualizzazione del file mappato alla memoria.

CreateViewAccessor(Int64, Int64)

Crea un oggetto MemoryMappedViewAccessor mappato a una visualizzazione del file mappato alla memoria, con l'offset e la dimensione specificati.

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Crea un oggetto MemoryMappedViewAccessor mappato a una visualizzazione del file mappato alla memoria, con l'offset, la dimensione e le restrizioni di accesso specificati.

CreateViewAccessor()

Origine:
MemoryMappedFile.cs
Origine:
MemoryMappedFile.cs
Origine:
MemoryMappedFile.cs

Crea un oggetto MemoryMappedViewAccessor mappato a una visualizzazione del file mappato alla memoria.

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

Restituisce

Blocco di memoria ad accesso casuale.

Eccezioni

L'accesso al file mappato alla memoria non è autorizzato.

Commenti

È possibile usare la visualizzazione restituita da questo metodo per l'accesso casuale a un file mappato alla memoria.

Vedi anche

Si applica a

CreateViewAccessor(Int64, Int64)

Origine:
MemoryMappedFile.cs
Origine:
MemoryMappedFile.cs
Origine:
MemoryMappedFile.cs

Crea un oggetto MemoryMappedViewAccessor mappato a una visualizzazione del file mappato alla memoria, con l'offset e la dimensione specificati.

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

Parametri

offset
Int64

Byte in corrispondenza del quale iniziare la visualizzazione.

size
Int64

Dimensione della visualizzazione. Specificare 0 (zero) per creare una visualizzazione che inizia in corrispondenza di offset e termina approssimativamente alla fine del file mappato alla memoria.

Restituisce

Blocco di memoria ad accesso casuale.

Eccezioni

offset o size è un valore negativo.

-oppure-

size è maggiore dello spazio degli indirizzi logico.

L'accesso al file mappato alla memoria non è autorizzato.

Si è verificato un errore di I/O.

Esempio

L'esempio seguente crea una visualizzazione di un file mappato alla memoria e lo modifica. Questo esempio di codice fa parte di un esempio più ampio fornito per la MemoryMappedFile classe .

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

Commenti

È possibile usare la visualizzazione restituita da questo metodo per l'accesso casuale a un file mappato alla memoria.

Per creare una visualizzazione completa del file mappato alla memoria, specificare 0 (zero) per il size parametro . In questo caso, le dimensioni della visualizzazione potrebbero essere maggiori delle dimensioni del file di origine su disco. Ciò è dovuto al fatto che le visualizzazioni vengono fornite in unità di pagine di sistema e le dimensioni della visualizzazione vengono arrotondate alle dimensioni della pagina di sistema successiva.

Vedi anche

Si applica a

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Origine:
MemoryMappedFile.cs
Origine:
MemoryMappedFile.cs
Origine:
MemoryMappedFile.cs

Crea un oggetto MemoryMappedViewAccessor mappato a una visualizzazione del file mappato alla memoria, con l'offset, la dimensione e le restrizioni di accesso specificati.

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

Parametri

offset
Int64

Byte in corrispondenza del quale iniziare la visualizzazione.

size
Int64

Dimensione della visualizzazione. Specificare 0 (zero) per creare una visualizzazione che inizia in corrispondenza di offset e termina approssimativamente alla fine del file mappato alla memoria.

access
MemoryMappedFileAccess

Uno dei valori di enumerazione che specifica il tipo di accesso consentito al file mappato alla memoria. Il valore predefinito è ReadWrite.

Restituisce

Blocco di memoria ad accesso casuale.

Attributi

Eccezioni

offset o size è un valore negativo.

-oppure-

size è maggiore dello spazio degli indirizzi logico.

access è non valido per il file mappato alla memoria.

Si è verificato un errore di I/O.

Commenti

È possibile usare la visualizzazione restituita da questo metodo per l'accesso casuale a un file mappato alla memoria.

Per creare una visualizzazione completa del file mappato alla memoria, specificare 0 (zero) per il size parametro . In questo caso, le dimensioni della visualizzazione potrebbero essere maggiori delle dimensioni del file di origine su disco. Ciò è dovuto al fatto che le visualizzazioni vengono fornite in unità di pagine di sistema e le dimensioni della visualizzazione vengono arrotondate alle dimensioni della pagina di sistema successiva.

Vedi anche

Si applica a