UnmanagedMemoryStream Constructores

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Inicializa una nueva instancia de la clase UnmanagedMemoryStream.

Sobrecargas

UnmanagedMemoryStream()	Inicializa una nueva instancia de la clase UnmanagedMemoryStream.
UnmanagedMemoryStream(Byte*, Int64)	Inicializa una nueva instancia de la clase UnmanagedMemoryStream utilizando la ubicación y la longitud de memoria especificadas.
UnmanagedMemoryStream(SafeBuffer, Int64, Int64)	Inicializa una nueva instancia de la clase UnmanagedMemoryStream en un búfer seguro con un desplazamiento y una longitud especificados.
UnmanagedMemoryStream(Byte*, Int64, Int64, FileAccess)	Inicializa una nueva instancia de la clase UnmanagedMemoryStream utilizando la ubicación especificada, la longitud de memoria, la cantidad total de memoria y los valores de acceso a archivos.
UnmanagedMemoryStream(SafeBuffer, Int64, Int64, FileAccess)	Inicializa una nueva instancia de la clase UnmanagedMemoryStream en un búfer seguro con un desplazamiento, una longitud y un acceso de archivo especificados.

UnmanagedMemoryStream()

Source:

UnmanagedMemoryStream.cs

Inicializa una nueva instancia de la clase UnmanagedMemoryStream.

protected:
 UnmanagedMemoryStream();

protected UnmanagedMemoryStream ();

Protected Sub New ()

Excepciones

SecurityException

El usuario no tiene el permiso necesario.

UnmanagedMemoryStream(Byte*, Int64)

Source:

UnmanagedMemoryStream.cs

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase UnmanagedMemoryStream utilizando la ubicación y la longitud de memoria especificadas.

public:
 UnmanagedMemoryStream(System::Byte* pointer, long length);

[System.CLSCompliant(false)]
public UnmanagedMemoryStream (byte* pointer, long length);

[<System.CLSCompliant(false)>]
new System.IO.UnmanagedMemoryStream : nativeptr<byte> * int64 -> System.IO.UnmanagedMemoryStream

Parámetros

pointer

Byte*

Puntero a una ubicación de memoria no administrada.

length

Int64

Longitud de la memoria que se va a usar.

Atributos

CLSCompliantAttribute

Excepciones

SecurityException

El usuario no tiene el permiso necesario.

ArgumentNullException

El valor de pointer es null.

ArgumentOutOfRangeException

El valor de length es menor que cero.

-o-

El length es lo suficientemente grande como para provocar un desbordamiento.

Ejemplos

En el ejemplo de código siguiente se muestra cómo leer y escribir en memoria no administrada mediante la clase UnmanagedMemoryStream. Se asigna un bloque de memoria no administrada y se desasigna mediante la clase Marshal.

// Note: You must compile this sample using the unsafe flag.
// From the command line, type the following: csc sample.cs /unsafe
using System;
using System.IO;
using System.Runtime.InteropServices;
using System.Text;

unsafe class Program
{
    static void Main()
    {
        // Create some data to write.
        byte[] text = UnicodeEncoding.Unicode.GetBytes("Data to write.");

        // Allocate a block of unmanaged memory.
        IntPtr memIntPtr = Marshal.AllocHGlobal(text.Length);

        // Get a byte pointer from the unmanaged memory block.
        byte* memBytePtr = (byte*)memIntPtr.ToPointer();

        UnmanagedMemoryStream writeStream =
            new UnmanagedMemoryStream(
            memBytePtr, text.Length, text.Length, FileAccess.Write);

        // Write the data.
        WriteToStream(writeStream, text);

        // Close the stream.
        writeStream.Close();

        // Create another UnmanagedMemoryStream for reading.
        UnmanagedMemoryStream readStream =
            new UnmanagedMemoryStream(memBytePtr, text.Length);

        // Display the contents of the stream to the console.
        PrintStream(readStream);

        // Close the reading stream.
        readStream.Close();

        // Free up the unmanaged memory.
        Marshal.FreeHGlobal(memIntPtr);
    }

    public static void WriteToStream(UnmanagedMemoryStream writeStream, byte[] text)
    {
        // Verify that the stream is writable:
        // By default, UnmanagedMemoryStream objects do not have write access,
        // write access must be set explicitly.
        if (writeStream.CanWrite)
        {
            // Write the data, byte by byte
            for (int i = 0; i < writeStream.Length; i++)
            {
                writeStream.WriteByte(text[i]);
            }
        }
    }

    public static void PrintStream(UnmanagedMemoryStream readStream)
    {
        byte[] text = new byte[readStream.Length];
        // Verify that the stream is writable:
        // By default, UnmanagedMemoryStream objects do not have write access,
        // write access must be set explicitly.
        if (readStream.CanRead)
        {
            // Write the data, byte by byte
            for (int i = 0; i < readStream.Length; i++)
            {
                text[i] = (byte)readStream.ReadByte();
            }
        }

        Console.WriteLine(UnicodeEncoding.Unicode.GetString(text));
    }
}

Comentarios

Este constructor crea una nueva instancia de la clase UnmanagedMemoryStream y, de forma predeterminada, establece la propiedad CanWrite en false y la propiedad CanRead en true. La propiedad Length se establece en el valor del parámetro length y no se puede cambiar.

UnmanagedMemoryStream(SafeBuffer, Int64, Int64)

Source:

UnmanagedMemoryStream.cs

Inicializa una nueva instancia de la clase UnmanagedMemoryStream en un búfer seguro con un desplazamiento y una longitud especificados.

public:
 UnmanagedMemoryStream(System::Runtime::InteropServices::SafeBuffer ^ buffer, long offset, long length);

public UnmanagedMemoryStream (System.Runtime.InteropServices.SafeBuffer buffer, long offset, long length);

new System.IO.UnmanagedMemoryStream : System.Runtime.InteropServices.SafeBuffer * int64 * int64 -> System.IO.UnmanagedMemoryStream

Public Sub New (buffer As SafeBuffer, offset As Long, length As Long)

Parámetros

buffer

SafeBuffer

Búfer que va a contener el flujo de memoria no administrado.

offset

Int64

Posición de bytes en el búfer en el que se va a iniciar la secuencia de memoria no administrada.

length

Int64

Longitud de la secuencia de memoria no administrada.

UnmanagedMemoryStream(Byte*, Int64, Int64, FileAccess)

Source:

UnmanagedMemoryStream.cs

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase UnmanagedMemoryStream utilizando la ubicación especificada, la longitud de memoria, la cantidad total de memoria y los valores de acceso a archivos.

public:
 UnmanagedMemoryStream(System::Byte* pointer, long length, long capacity, System::IO::FileAccess access);

[System.CLSCompliant(false)]
public UnmanagedMemoryStream (byte* pointer, long length, long capacity, System.IO.FileAccess access);

[<System.CLSCompliant(false)>]
new System.IO.UnmanagedMemoryStream : nativeptr<byte> * int64 * int64 * System.IO.FileAccess -> System.IO.UnmanagedMemoryStream

Parámetros

pointer

Byte*

Puntero a una ubicación de memoria no administrada.

length

Int64

Longitud de la memoria que se va a usar.

capacity

Int64

Cantidad total de memoria asignada a la secuencia.

access

FileAccess

Uno de los valores de FileAccess.

Atributos

CLSCompliantAttribute

Excepciones

SecurityException

El usuario no tiene el permiso necesario.

ArgumentNullException

El valor de pointer es null.

ArgumentOutOfRangeException

El valor de length es menor que cero.

-o-

El valor de capacity es menor que cero.

-o-

El valor length es mayor que el valor de capacity.

Ejemplos

En el ejemplo de código siguiente se muestra cómo leer y escribir en memoria no administrada mediante la clase UnmanagedMemoryStream. Se asigna un bloque de memoria no administrada y se desasigna mediante la clase Marshal.

// Note: you must compile this sample using the unsafe flag.
// From the command line, type the following: csc sample.cs /unsafe

using System;
using System.IO;
using System.Text;
using System.Runtime.InteropServices;

unsafe class TestWriter
{
    static void Main()
    {
        // Create some data to read and write.
        byte[] message = UnicodeEncoding.Unicode.GetBytes("Here is some data.");

        // Allocate a block of unmanaged memory and return an IntPtr object.	
        IntPtr memIntPtr = Marshal.AllocHGlobal(message.Length);

        // Get a byte pointer from the IntPtr object.
        byte* memBytePtr = (byte*)memIntPtr.ToPointer();

        // Create an UnmanagedMemoryStream object using a pointer to unmanaged memory.
        UnmanagedMemoryStream writeStream = new UnmanagedMemoryStream(memBytePtr, message.Length, message.Length, FileAccess.Write);

        // Write the data.
        writeStream.Write(message, 0, message.Length);

        // Close the stream.
        writeStream.Close();

        // Create another UnmanagedMemoryStream object using a pointer to unmanaged memory.
        UnmanagedMemoryStream readStream = new UnmanagedMemoryStream(memBytePtr, message.Length, message.Length, FileAccess.Read);

        // Create a byte array to hold data from unmanaged memory.
        byte[] outMessage = new byte[message.Length];

        // Read from unmanaged memory to the byte array.
        readStream.Read(outMessage, 0, message.Length);

        // Close the stream.
        readStream.Close();

        // Display the data to the console.
        Console.WriteLine(UnicodeEncoding.Unicode.GetString(outMessage));

        // Free the block of unmanaged memory.
        Marshal.FreeHGlobal(memIntPtr);

        Console.ReadLine();
    }
}

Comentarios

El parámetro length define la cantidad actual de memoria en uso. Si lee o anexa datos a la secuencia, el valor de length debe ser igual a la cantidad de datos válidos de la secuencia que se van a leer o conservar. Si escribe en la secuencia, este valor debe ser cero.

El parámetro capacity indica la cantidad de memoria total disponible. Este valor puede describir una región que sea mayor que la longitud especificada o indicar una región a la que se puede anexar. Se producirá un error en cualquier intento de escritura más allá de este valor.

El parámetro access establece las propiedades CanReady CanWrite. Tenga en cuenta que especificar Write no garantiza que la secuencia se pueda escribir. Los parámetros de acceso permiten al implementador crear un objeto cuya implementación pueda coincidir con la secuencia real expuesta.

UnmanagedMemoryStream(SafeBuffer, Int64, Int64, FileAccess)

Source:

UnmanagedMemoryStream.cs

Inicializa una nueva instancia de la clase UnmanagedMemoryStream en un búfer seguro con un desplazamiento, una longitud y un acceso de archivo especificados.

public:
 UnmanagedMemoryStream(System::Runtime::InteropServices::SafeBuffer ^ buffer, long offset, long length, System::IO::FileAccess access);

public UnmanagedMemoryStream (System.Runtime.InteropServices.SafeBuffer buffer, long offset, long length, System.IO.FileAccess access);

new System.IO.UnmanagedMemoryStream : System.Runtime.InteropServices.SafeBuffer * int64 * int64 * System.IO.FileAccess -> System.IO.UnmanagedMemoryStream

Public Sub New (buffer As SafeBuffer, offset As Long, length As Long, access As FileAccess)

Parámetros

buffer

SafeBuffer

Búfer que va a contener el flujo de memoria no administrado.

offset

Int64

Posición de bytes en el búfer en el que se va a iniciar la secuencia de memoria no administrada.

length

Int64

Longitud de la secuencia de memoria no administrada.

access

FileAccess

Modo de acceso de archivo a la secuencia de memoria no administrada.