MemoryMappedFile.CreateViewAccessor Metodo

Definizione

Spazio dei nomi:
System.IO.MemoryMappedFiles
Assembly:
System.Core.dll
Assembly:
netstandard.dll

Crea un oggetto MemoryMappedViewAccessor che esegue il mapping a una visualizzazione del file mappato alla memoria.

Overload

Nome Descrizione
CreateViewAccessor()

Crea un oggetto MemoryMappedViewAccessor che esegue il mapping a una visualizzazione del file mappato alla memoria.
CreateViewAccessor(Int64, Int64)

Crea un oggetto MemoryMappedViewAccessor che esegue il mapping a una visualizzazione del file mappato alla memoria e con l'offset e le dimensioni specificati.
CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Crea un oggetto MemoryMappedViewAccessor che esegue il mapping a una visualizzazione del file mappato alla memoria e che presenta l'offset, le dimensioni e le restrizioni di accesso specificati.

CreateViewAccessor()

Crea un oggetto MemoryMappedViewAccessor che esegue il mapping 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

Valori restituiti

MemoryMappedViewAccessor

Blocco di memoria accessibile in modo 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

Si applica a

CreateViewAccessor(Int64, Int64)

Crea un oggetto MemoryMappedViewAccessor che esegue il mapping a una visualizzazione del file mappato alla memoria e con l'offset e le dimensioni 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 avviare la visualizzazione.

size
Int64

Dimensioni della visualizzazione. Specificare 0 (zero) per creare una vista che inizia da offset e termina approssimativamente alla fine del file mappato alla memoria.

Valori restituiti

MemoryMappedViewAccessor

Blocco di memoria accessibile in modo casuale.

Eccezioni

ArgumentOutOfRangeException

offset o size è un valore negativo.

oppure

size è maggiore dello spazio indirizzi logico.

UnauthorizedAccessException

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

IOException

Si è verificato un errore di I/O.

Esempio

Nell'esempio seguente viene creata una visualizzazione di un file mappato alla memoria e la 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 fino alle dimensioni successive della pagina di sistema.

Vedi anche

Si applica a

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Crea un oggetto MemoryMappedViewAccessor che esegue il mapping a una visualizzazione del file mappato alla memoria e che presenta l'offset, le dimensioni e le restrizioni di accesso specificati.

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);
public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor(long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);
[<System.Security.SecurityCritical>]
member this.CreateViewAccessor : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor
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 avviare la visualizzazione.

size
Int64

Dimensioni della visualizzazione. Specificare 0 (zero) per creare una vista che inizia da 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.

Valori restituiti

MemoryMappedViewAccessor

Blocco di memoria accessibile in modo casuale.

Attributi
SecurityCriticalAttribute

Eccezioni

ArgumentOutOfRangeException

offset o size è un valore negativo.

oppure

size è maggiore dello spazio 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 fino alle dimensioni successive della pagina di sistema.

Vedi anche

Si applica a