MemoryMappedFile.CreateViewAccessor Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea un objeto MemoryMappedViewAccessor que se asigna a una vista del archivo asignado a memoria.
Sobrecargas
| Nombre | Description |
|---|---|
| CreateViewAccessor() |
Crea un objeto MemoryMappedViewAccessor que se asigna a una vista del archivo asignado a memoria. |
| CreateViewAccessor(Int64, Int64) |
Crea un MemoryMappedViewAccessor objeto que se asigna a una vista del archivo asignado a memoria y que tiene el desplazamiento y el tamaño especificados. |
| CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess) |
Crea un MemoryMappedViewAccessor objeto que se asigna a una vista del archivo asignado a memoria y que tiene las restricciones de desplazamiento, tamaño y acceso especificadas. |
CreateViewAccessor()
Crea un objeto MemoryMappedViewAccessor que se asigna a una vista del archivo asignado a memoria.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor();public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor();member this.CreateViewAccessor : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessorPublic Function CreateViewAccessor () As MemoryMappedViewAccessorDevoluciones
Bloque de memoria accesible aleatoriamente.
Excepciones
El acceso al archivo asignado a memoria no está autorizado.
Comentarios
Puede usar la vista devuelta por este método para el acceso aleatorio a un archivo asignado a memoria.
Consulte también
Se aplica a
CreateViewAccessor(Int64, Int64)
Crea un MemoryMappedViewAccessor objeto que se asigna a una vista del archivo asignado a memoria y que tiene el desplazamiento y el tamaño especificados.
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 MemoryMappedViewAccessorParámetros
- offset
- Int64
Byte en el que se va a iniciar la vista.
- size
- Int64
Tamaño de la vista. Especifique 0 (cero) para crear una vista que comience en offset y finalice aproximadamente al final del archivo asignado a memoria.
Devoluciones
Bloque de memoria accesible aleatoriamente.
Excepciones
offset o size es un valor negativo.
O bien
size es mayor que el espacio de direcciones lógico.
El acceso al archivo asignado a memoria no está autorizado.
Error de E/S.
Ejemplos
En el ejemplo siguiente se crea una vista de un archivo asignado a memoria y se edita. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la MemoryMappedFile clase .
// 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
Comentarios
Puede usar la vista devuelta por este método para el acceso aleatorio a un archivo asignado a memoria.
Para crear una vista completa del archivo asignado a memoria, especifique 0 (cero) para el size parámetro . Si lo hace, el tamaño de la vista puede ser mayor que el tamaño del archivo de origen en el disco. Esto se debe a que las vistas se proporcionan en unidades de páginas del sistema y el tamaño de la vista se redondea al siguiente tamaño de página del sistema.
Consulte también
Se aplica a
CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)
Crea un MemoryMappedViewAccessor objeto que se asigna a una vista del archivo asignado a memoria y que tiene las restricciones de desplazamiento, tamaño y acceso especificadas.
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.MemoryMappedViewAccessormember this.CreateViewAccessor : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessorPublic Function CreateViewAccessor (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewAccessorParámetros
- offset
- Int64
Byte en el que se va a iniciar la vista.
- size
- Int64
Tamaño de la vista. Especifique 0 (cero) para crear una vista que comience en offset y finalice aproximadamente al final del archivo asignado a memoria.
- access
- MemoryMappedFileAccess
Uno de los valores de enumeración que especifica el tipo de acceso permitido al archivo asignado a memoria. El valor predeterminado es ReadWrite.
Devoluciones
Bloque de memoria accesible aleatoriamente.
- Atributos
Excepciones
offset o size es un valor negativo.
O bien
size es mayor que el espacio de direcciones lógico.
access no es válido para el archivo asignado a memoria.
Error de E/S.
Comentarios
Puede usar la vista devuelta por este método para el acceso aleatorio a un archivo asignado a memoria.
Para crear una vista completa del archivo asignado a memoria, especifique 0 (cero) para el size parámetro . Si lo hace, el tamaño de la vista puede ser mayor que el tamaño del archivo de origen en el disco. Esto se debe a que las vistas se proporcionan en unidades de páginas del sistema y el tamaño de la vista se redondea al siguiente tamaño de página del sistema.