MemoryMappedFile.CreateViewAccessor Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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()
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.MemoryMappedViewAccessorPublic Function CreateViewAccessor () As MemoryMappedViewAccessorRestituisce
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)
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.MemoryMappedViewAccessorPublic Function CreateViewAccessor (offset As Long, size As Long) As MemoryMappedViewAccessorParametri
- 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)
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.MemoryMappedViewAccessorPublic Function CreateViewAccessor (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewAccessorParametri
- 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.