UnmanagedMemoryStream Конструкторы

Определение

Инициализирует новый экземпляр класса UnmanagedMemoryStream.Initializes a new instance of the UnmanagedMemoryStream class.

Перегрузки

UnmanagedMemoryStream()

Инициализирует новый экземпляр класса UnmanagedMemoryStream.Initializes a new instance of the UnmanagedMemoryStream class.

UnmanagedMemoryStream(Byte*, Int64)

Инициализирует новый экземпляр класса UnmanagedMemoryStream, используя заданное расположение и объем памяти.Initializes a new instance of the UnmanagedMemoryStream class using the specified location and memory length.

UnmanagedMemoryStream(SafeBuffer, Int64, Int64)

Инициализирует новый экземпляр класса UnmanagedMemoryStream в безопасном буфере с указанным смещением и длиной.Initializes a new instance of the UnmanagedMemoryStream class in a safe buffer with a specified offset and length.

UnmanagedMemoryStream(Byte*, Int64, Int64, FileAccess)

Инициализирует новый экземпляр класса UnmanagedMemoryStream, используя указанные значения расположения, объема памяти, общего объема памяти и доступа к файлам.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)

Инициализирует новый экземпляр класса UnmanagedMemoryStream в безопасном буфере с указанными смещением, длиной и правами доступа к файлам.Initializes a new instance of the UnmanagedMemoryStream class in a safe buffer with a specified offset, length, and file access.

UnmanagedMemoryStream()

Инициализирует новый экземпляр класса UnmanagedMemoryStream.Initializes a new instance of the UnmanagedMemoryStream class.

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

Исключения

Пользователь не имеет необходимого разрешения.The user does not have the required permission.

UnmanagedMemoryStream(Byte*, Int64)

Важно!

Этот API несовместим с CLS.

Инициализирует новый экземпляр класса UnmanagedMemoryStream, используя заданное расположение и объем памяти.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);
public UnmanagedMemoryStream (byte* pointer, long length);
[System.CLSCompliant(false)]
public UnmanagedMemoryStream (byte* pointer, long length);
new System.IO.UnmanagedMemoryStream : nativeptr<byte> * int64 -> System.IO.UnmanagedMemoryStream

Параметры

pointer
Byte*

Указатель на расположение неуправляемой памятью.A pointer to an unmanaged memory location.

length
Int64

Используемый объем памяти.The length of the memory to use.

Атрибуты

Исключения

Пользователь не имеет необходимого разрешения.The user does not have the required permission.

Значение параметра pointernull.The pointer value is null.

Значение параметра length меньше нуля.The length value is less than zero.

-или--or- Значение параметра length достаточно велико, чтобы привести к переполнению.The length is large enough to cause an overflow.

Примеры

В следующем примере кода показано, как выполнять чтение из неуправляемой памяти и запись в нее с помощью класса UnmanagedMemoryStream.The following code example demonstrates how to read from and write to unmanaged memory using the UnmanagedMemoryStream class. Блок неуправляемой памяти выделяется и освобождается с помощью класса Marshal.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));
    }
}

Комментарии

Этот конструктор создает новый экземпляр класса UnmanagedMemoryStream, а по умолчанию присваивает свойству CanWrite значение false, а свойству CanRead — значение true.This constructor creates a new instance of the UnmanagedMemoryStream class, and by default sets the CanWrite property to false and the CanRead property to true. Свойству Length присвоено значение параметра length, и его нельзя изменить.The Length property is set to the value of the length parameter and cannot be changed.

UnmanagedMemoryStream(SafeBuffer, Int64, Int64)

Инициализирует новый экземпляр класса UnmanagedMemoryStream в безопасном буфере с указанным смещением и длиной.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)

Параметры

buffer
SafeBuffer

Буфер, который должен содержать поток неуправляемой памяти.The buffer to contain the unmanaged memory stream.

offset
Int64

Позиция байта в буфере, с которой должен начинаться поток неуправляемой памяти.The byte position in the buffer at which to start the unmanaged memory stream.

length
Int64

Длина потока неуправляемой памяти.The length of the unmanaged memory stream.

UnmanagedMemoryStream(Byte*, Int64, Int64, FileAccess)

Важно!

Этот API несовместим с CLS.

Инициализирует новый экземпляр класса UnmanagedMemoryStream, используя указанные значения расположения, объема памяти, общего объема памяти и доступа к файлам.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);
public UnmanagedMemoryStream (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);
new System.IO.UnmanagedMemoryStream : nativeptr<byte> * int64 * int64 * System.IO.FileAccess -> System.IO.UnmanagedMemoryStream

Параметры

pointer
Byte*

Указатель на расположение неуправляемой памяти.A pointer to an unmanaged memory location.

length
Int64

Используемый объем памяти.The length of the memory to use.

capacity
Int64

Общий объем памяти, назначенный для потока.The total amount of memory assigned to the stream.

access
FileAccess

Одно из значений перечисления FileAccess.One of the FileAccess values.

Атрибуты

Исключения

Пользователь не имеет необходимого разрешения.The user does not have the required permission.

Значение параметра pointernull.The pointer value is null.

Значение параметра length меньше нуля.The length value is less than zero.

-или--or- Значение параметра capacity меньше нуля.The capacity value is less than zero.

-или--or- Значение параметра length больше, чем значение capacity.The length value is greater than the capacity value.

Примеры

В следующем примере кода показано, как выполнять чтение из неуправляемой памяти и запись в нее с помощью класса UnmanagedMemoryStream.The following code example demonstrates how to read from and write to unmanaged memory using the UnmanagedMemoryStream class. Блок неуправляемой памяти выделяется и освобождается с помощью класса Marshal.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();
    }
}

Комментарии

Параметр length определяет текущий объем используемой памяти.The length parameter defines the current amount of memory in use. При чтении или добавлении данных в поток значение length должно быть равно объему допустимых данных в потоке, которые должны быть считаны или сохранены.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. При записи в поток это значение должно быть равно нулю.If writing to the stream, this value should be zero.

Параметр capacity указывает общий объем доступной памяти.The capacity parameter indicates the amount of total memory available. Это значение может описывать регион, длина которого превышает указанную длину, или указать область, к которой можно добавить данные.This value can describe a region that is longer than the length specified, or indicate a region that can be appended to. Любая попытка записи после этого значения завершится ошибкой.Any attempt to write beyond this value will fail.

Параметр access задает свойства CanReadи CanWrite.The access parameter sets the CanRead, and CanWrite properties. Обратите внимание, что указание Write не гарантирует, что поток будет доступен для записи.Note that specifying Write does not guarantee that the stream will be writable. Параметры доступа позволяют разработчику создать объект, реализация которого может соответствовать фактическому представленному потоку.The access parameters allow the implementer to create an object whose implementation can match the actual stream that is exposed.

UnmanagedMemoryStream(SafeBuffer, Int64, Int64, FileAccess)

Инициализирует новый экземпляр класса UnmanagedMemoryStream в безопасном буфере с указанными смещением, длиной и правами доступа к файлам.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)

Параметры

buffer
SafeBuffer

Буфер, который должен содержать поток неуправляемой памяти.The buffer to contain the unmanaged memory stream.

offset
Int64

Позиция байта в буфере, с которой должен начинаться поток неуправляемой памяти.The byte position in the buffer at which to start the unmanaged memory stream.

length
Int64

Длина потока неуправляемой памяти.The length of the unmanaged memory stream.

access
FileAccess

Режим доступа к файлам для потока неуправляемой памяти.The mode of file access to the unmanaged memory stream.

Применяется к