UnmanagedMemoryStream Construtores

Definição

Inicializa uma nova instância da classe UnmanagedMemoryStream.Initializes a new instance of the UnmanagedMemoryStream class.

Sobrecargas

UnmanagedMemoryStream()

Inicializa uma nova instância da classe UnmanagedMemoryStream.Initializes a new instance of the UnmanagedMemoryStream class.

UnmanagedMemoryStream(Byte*, Int64)

Inicializa uma nova instância da classe UnmanagedMemoryStream usando o tamanho da memória e o local especificados.Initializes a new instance of the UnmanagedMemoryStream class using the specified location and memory length.

UnmanagedMemoryStream(SafeBuffer, Int64, Int64)

Inicializa uma nova instância da classe UnmanagedMemoryStream em um buffer seguro com deslocamento e comprimento especificados.Initializes a new instance of the UnmanagedMemoryStream class in a safe buffer with a specified offset and length.

UnmanagedMemoryStream(Byte*, Int64, Int64, FileAccess)

Inicializa uma nova instância da classe UnmanagedMemoryStream usando o local, o tamanho da memória, a quantidade total de memória e os valores de acesso ao arquivo.Initializes a new instance of the UnmanagedMemoryStream class using the specified location, memory length, total amount of memory, and file access values.

UnmanagedMemoryStream(SafeBuffer, Int64, Int64, FileAccess)

Inicializa uma nova instância da classe UnmanagedMemoryStream em um buffer seguro com um deslocamento, tamanho e acesso a arquivos especificados.Initializes a new instance of the UnmanagedMemoryStream class in a safe buffer with a specified offset, length, and file access.

UnmanagedMemoryStream()

Inicializa uma nova instância da classe UnmanagedMemoryStream.Initializes a new instance of the UnmanagedMemoryStream class.

protected:
 UnmanagedMemoryStream();
protected UnmanagedMemoryStream ();
Protected Sub New ()

Exceções

O usuário não tem a permissão necessária.The user does not have the required permission.

Segurança

UnmanagedCode
para acessar a memória não gerenciada.for accessing unmanaged memory.

UnmanagedMemoryStream(Byte*, Int64)

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe UnmanagedMemoryStream usando o tamanho da memória e o local especificados.Initializes a new instance of the UnmanagedMemoryStream class using the specified location and memory length.

public:
 UnmanagedMemoryStream(System::Byte* pointer, long length);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public UnmanagedMemoryStream (byte* pointer, long length);
new System.IO.UnmanagedMemoryStream : nativeptr<byte> * int64 -> System.IO.UnmanagedMemoryStream

Parâmetros

pointer
Byte*

Um ponteiro para um local da memória não gerenciado.A pointer to an unmanaged memory location.

length
Int64

O tamanho da memória a ser usado.The length of the memory to use.

Atributos

Exceções

O usuário não tem a permissão necessária.The user does not have the required permission.

O valor pointer é null.The pointer value is null.

O valor length é menor que zero.The length value is less than zero.

- ou --or- O length é grande o suficiente para causar um estouro.The length is large enough to cause an overflow.

Exemplos

O exemplo de código a seguir demonstra como ler e gravar na memória não gerenciada usando a UnmanagedMemoryStream classe.The following code example demonstrates how to read from and write to unmanaged memory using the UnmanagedMemoryStream class. Um bloco de memória não gerenciada é alocado e desalocado usando a Marshal classe.A block of unmanaged memory is allocated and de-allocated using the Marshal class.

// 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));
    }
}

Comentários

Esse construtor cria uma nova UnmanagedMemoryStream instância da classe e, por padrão, define a CanWrite Propriedade como false e a CanRead Propriedade como. trueThis constructor creates a new instance of the UnmanagedMemoryStream class, and by default sets the CanWrite property to false and the CanRead property to true. A Length propriedade é definida como o valor length do parâmetro e não pode ser alterada.The Length property is set to the value of the length parameter and cannot be changed.

Segurança

UnmanagedCode
para acessar a memória não gerenciada.for accessing unmanaged memory.

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

UnmanagedMemoryStream(SafeBuffer, Int64, Int64)

Inicializa uma nova instância da classe UnmanagedMemoryStream em um buffer seguro com deslocamento e comprimento especificados.Initializes a new instance of the UnmanagedMemoryStream class in a safe buffer with a specified offset and length.

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

O buffer que conterá o fluxo de memória não gerenciada.The buffer to contain the unmanaged memory stream.

offset
Int64

A posição de bytes no buffer na qual o fluxo de memória não gerenciada será iniciado.The byte position in the buffer at which to start the unmanaged memory stream.

length
Int64

O tamanho do fluxo de memória não gerenciada.The length of the unmanaged memory stream.

UnmanagedMemoryStream(Byte*, Int64, Int64, FileAccess)

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe UnmanagedMemoryStream usando o local, o tamanho da memória, a quantidade total de memória e os valores de acesso ao arquivo.Initializes a new instance of the UnmanagedMemoryStream class using the specified location, memory length, total amount of memory, and file access values.

public:
 UnmanagedMemoryStream(System::Byte* pointer, long length, long capacity, System::IO::FileAccess access);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public UnmanagedMemoryStream (byte* pointer, long length, long capacity, System.IO.FileAccess access);
new System.IO.UnmanagedMemoryStream : nativeptr<byte> * int64 * int64 * System.IO.FileAccess -> System.IO.UnmanagedMemoryStream

Parâmetros

pointer
Byte*

Um ponteiro para um local da memória não gerenciado.A pointer to an unmanaged memory location.

length
Int64

O tamanho da memória a ser usado.The length of the memory to use.

capacity
Int64

A quantidade total de memória atribuída ao fluxo.The total amount of memory assigned to the stream.

access
FileAccess

Um dos valores de FileAccess.One of the FileAccess values.

Atributos

Exceções

O usuário não tem a permissão necessária.The user does not have the required permission.

O valor pointer é null.The pointer value is null.

O valor length é menor que zero.The length value is less than zero.

- ou --or- O valor capacity é menor que zero.The capacity value is less than zero.

- ou --or- O valor length é maior que o valor capacity.The length value is greater than the capacity value.

Exemplos

O exemplo de código a seguir demonstra como ler e gravar na memória não gerenciada usando a UnmanagedMemoryStream classe.The following code example demonstrates how to read from and write to unmanaged memory using the UnmanagedMemoryStream class. Um bloco de memória não gerenciada é alocado e desalocado usando a Marshal classe.A block of unmanaged memory is allocated and de-allocated using the Marshal class.


// 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();
    }
}

Comentários

O length parâmetro define a quantidade atual de memória em uso.The length parameter defines the current amount of memory in use. Se você estiver lendo ou acrescentando dados ao fluxo, length o valor deverá ser igual à quantidade de dados válidos no fluxo a ser lido ou preservado.If reading or appending data to the stream, the length value should be equal to the amount of valid data in the stream to be read from or preserved. Se estiver gravando no fluxo, esse valor deverá ser zero.If writing to the stream, this value should be zero.

O capacity parâmetro indica a quantidade de memória total disponível.The capacity parameter indicates the amount of total memory available. Esse valor pode descrever uma região maior que o comprimento especificado, ou indicar uma região que pode ser acrescentada a.This value can describe a region that is longer than the length specified, or indicate a region that can be appended to. Qualquer tentativa de gravação além desse valor falhará.Any attempt to write beyond this value will fail.

O access parâmetro define as CanReadPropriedades e CanWrite .The access parameter sets the CanRead, and CanWrite properties. Observe que especificar Write não garante que o fluxo será gravável.Note that specifying Write does not guarantee that the stream will be writable. Os parâmetros de acesso permitem que o implementador crie um objeto cuja implementação pode corresponder ao fluxo real exposto.The access parameters allow the implementer to create an object whose implementation can match the actual stream that is exposed.

Segurança

UnmanagedCode
para acessar a memória não gerenciada.for accessing unmanaged memory.

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

UnmanagedMemoryStream(SafeBuffer, Int64, Int64, FileAccess)

Inicializa uma nova instância da classe UnmanagedMemoryStream em um buffer seguro com um deslocamento, tamanho e acesso a arquivos especificados.Initializes a new instance of the UnmanagedMemoryStream class in a safe buffer with a specified offset, length, and file access.

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

O buffer que conterá o fluxo de memória não gerenciada.The buffer to contain the unmanaged memory stream.

offset
Int64

A posição de bytes no buffer na qual o fluxo de memória não gerenciada será iniciado.The byte position in the buffer at which to start the unmanaged memory stream.

length
Int64

O tamanho do fluxo de memória não gerenciada.The length of the unmanaged memory stream.

access
FileAccess

O modo de acesso ao arquivo para o fluxo de memória não gerenciada.The mode of file access to the unmanaged memory stream.

Aplica-se a