MemoryMappedFile.CreateViewAccessor Metodo

Definizione

Spazio dei nomi:

System.IO.MemoryMappedFiles

Assembly:

System.IO.MemoryMappedFiles.dll

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

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

MemoryMappedViewAccessor

Blocco di memoria ad accesso casuale.

Eccezioni

UnauthorizedAccessException

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

• File mappati alla memoria

CreateViewAccessor(Int64, Int64)

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

MemoryMappedViewAccessor

Blocco di memoria ad accesso casuale.

Eccezioni

ArgumentOutOfRangeException

offset o size è un valore negativo.

-oppure-

size è maggiore dello spazio degli indirizzi logico.

UnauthorizedAccessException

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

IOException

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

• File mappati alla memoria

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

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);

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

MemoryMappedViewAccessor

Blocco di memoria ad accesso casuale.

Eccezioni

ArgumentOutOfRangeException

offset o size è un valore negativo.

-oppure-

size è maggiore dello spazio degli indirizzi logico.

UnauthorizedAccessException

access è non valido per il file mappato alla memoria.

IOException

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

• File mappati alla memoria