MemoryMappedFile.CreateViewAccessor Método

Definición

Espacio de nombres:

System.IO.MemoryMappedFiles

Ensamblado:

System.IO.MemoryMappedFiles.dll

Crea un MemoryMappedViewAccessor que se asigna a una vista del archivo asignado a la memoria.

Sobrecargas

CreateViewAccessor()	Crea un MemoryMappedViewAccessor que se asigna a una vista del archivo asignado a la memoria.
CreateViewAccessor(Int64, Int64)	Crea un MemoryMappedViewAccessor que se asigna a una vista del archivo asignado a la memoria y que tiene el desplazamiento y el tamaño especificados.
CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)	Crea un MemoryMappedViewAccessor que se asigna a una vista del archivo asignado a la memoria y que tiene el desplazamiento, el tamaño y las restricciones de acceso especificados.

CreateViewAccessor()

Source:

MemoryMappedFile.cs

Crea un MemoryMappedViewAccessor que se asigna a una vista del archivo asignado a la 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

Devoluciones

MemoryMappedViewAccessor

Bloque de memoria de acceso aleatorio.

Excepciones

UnauthorizedAccessException

No se autoriza el acceso al archivo asignado a la memoria.

Comentarios

Puede usar la vista devuelta por este método para el acceso aleatorio a un archivo asignado a memoria.

Consulte también

• Archivos asignados a memoria

CreateViewAccessor(Int64, Int64)

Source:

MemoryMappedFile.cs

Crea un MemoryMappedViewAccessor que se asigna a una vista del archivo asignado a la 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.MemoryMappedViewAccessor

Public Function CreateViewAccessor (offset As Long, size As Long) As MemoryMappedViewAccessor

Parámetros

offset

Int64

Byte en el que va a comenzar la vista.

size

Int64

Tamaño de la vista. Especifique 0 (cero) para crear una vista que empiece en offset y termine aproximadamente en el final del archivo asignado a la memoria.

Devoluciones

MemoryMappedViewAccessor

Bloque de memoria de acceso aleatorio.

Excepciones

ArgumentOutOfRangeException

El valor de offset o size es negativo.

O bien

size es mayor que el espacio de direcciones lógico.

UnauthorizedAccessException

No se autoriza el acceso al archivo asignado a la memoria.

IOException

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 es parte de un ejemplo mayor proporcionado para la clase MemoryMappedFile.

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

• Archivos asignados a memoria

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Source:

MemoryMappedFile.cs

Crea un MemoryMappedViewAccessor que se asigna a una vista del archivo asignado a la memoria y que tiene el desplazamiento, el tamaño y las restricciones de acceso especificados.

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

Parámetros

offset

Int64

Byte en el que va a comenzar la vista.

size

Int64

Tamaño de la vista. Especifique 0 (cero) para crear una vista que empiece en offset y termine aproximadamente en el final del archivo asignado a la memoria.

access

MemoryMappedFileAccess

Uno de los valores de enumeración que especifica el tipo de acceso permitido para el archivo asignado a la memoria. De manera predeterminada, es ReadWrite.

Devoluciones

MemoryMappedViewAccessor

Bloque de memoria de acceso aleatorio.

Excepciones

ArgumentOutOfRangeException

El valor de offset o size es negativo.

O bien

size es mayor que el espacio de direcciones lógico.

UnauthorizedAccessException

access no es válido para el archivo asignado por memoria.

IOException

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.

Consulte también

• Archivos asignados a memoria