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

Определение

Инициализация нового экземпляра класса MemoryStream.Initializes a new instance of the MemoryStream class.

Перегрузки

MemoryStream()

Инициализирует новый экземпляр класса MemoryStream расширяемой производительностью, инициализированной нулевым значением.Initializes a new instance of the MemoryStream class with an expandable capacity initialized to zero.

MemoryStream(Byte[])

Инициализирует новый неизменяемый экземпляр класса MemoryStream на основе указанного массива байтов.Initializes a new non-resizable instance of the MemoryStream class based on the specified byte array.

MemoryStream(Int32)

Инициализирует новый экземпляр класса MemoryStream расширяемой емкостью, инициализированной с указанным значением.Initializes a new instance of the MemoryStream class with an expandable capacity initialized as specified.

MemoryStream(Byte[], Boolean)

Инициализирует новый неизменяемый экземпляр класса MemoryStream на основе указанного массива байтов с помощью указанного значения свойства CanWrite.Initializes a new non-resizable instance of the MemoryStream class based on the specified byte array with the CanWrite property set as specified.

MemoryStream(Byte[], Int32, Int32)

Инициализирует новый неизменяемый экземпляр класса MemoryStream на основе указанной области (индекса) массива байтов.Initializes a new non-resizable instance of the MemoryStream class based on the specified region (index) of a byte array.

MemoryStream(Byte[], Int32, Int32, Boolean)

Инициализирует новый неизменяемый экземпляр класса MemoryStream на основе указанной области массива байтов с помощью указанного значения свойства CanWrite.Initializes a new non-resizable instance of the MemoryStream class based on the specified region of a byte array, with the CanWrite property set as specified.

MemoryStream(Byte[], Int32, Int32, Boolean, Boolean)

Инициализирует новый экземпляр класса MemoryStream на основе указанной области массива байтов с помощью указанного значения свойства CanWrite и возможности вызова GetBuffer() с указанным значением.Initializes a new instance of the MemoryStream class based on the specified region of a byte array, with the CanWrite property set as specified, and the ability to call GetBuffer() set as specified.

MemoryStream()

Инициализирует новый экземпляр класса MemoryStream расширяемой производительностью, инициализированной нулевым значением.Initializes a new instance of the MemoryStream class with an expandable capacity initialized to zero.

public:
 MemoryStream();
public MemoryStream ();
Public Sub New ()

Комментарии

Свойства CanRead, CanSeekи CanWrite имеют значение true.The CanRead, CanSeek, and CanWrite properties are all set to true.

Емкость текущего потока автоматически увеличивается при использовании метода SetLength, чтобы задать для длины значение, превышающее емкость текущего потока.The capacity of the current stream automatically increases when you use the SetLength method to set the length to a value larger than the capacity of the current stream.

Этот конструктор предоставляет базовый поток, который GetBuffer возвращает.This constructor exposes the underlying stream, which GetBuffer returns.

Дополнительно

MemoryStream(Byte[])

Инициализирует новый неизменяемый экземпляр класса MemoryStream на основе указанного массива байтов.Initializes a new non-resizable instance of the MemoryStream class based on the specified byte array.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer);
public MemoryStream (byte[] buffer);
new System.IO.MemoryStream : byte[] -> System.IO.MemoryStream
Public Sub New (buffer As Byte())

Параметры

buffer
Byte[]

Массив байтов без знака, из которого создается текущий поток.The array of unsigned bytes from which to create the current stream.

Исключения

Свойство buffer имеет значение null.buffer is null.

Комментарии

Свойства CanRead, CanSeekи CanWrite имеют значение true.The CanRead, CanSeek, and CanWrite properties are all set to true. для Capacity задана длина указанного массива байтов.Capacity is set to the length of the specified byte array. Новый поток может быть записан в, но его размер изменять нельзя.The new stream can be written to, but is not resizable.

Длина потока не может быть больше начальной длины указанного массива байтов; Однако поток можно усечь (см. SetLength).The length of the stream cannot be set to a value greater than the initial length of the specified byte array; however, the stream can be truncated (see SetLength).

Этот конструктор не предоставляет базовый поток.This constructor does not expose the underlying stream. GetBuffer выдает UnauthorizedAccessException.GetBuffer throws UnauthorizedAccessException.

Дополнительно

MemoryStream(Int32)

Инициализирует новый экземпляр класса MemoryStream расширяемой емкостью, инициализированной с указанным значением.Initializes a new instance of the MemoryStream class with an expandable capacity initialized as specified.

public:
 MemoryStream(int capacity);
public MemoryStream (int capacity);
new System.IO.MemoryStream : int -> System.IO.MemoryStream
Public Sub New (capacity As Integer)

Параметры

capacity
Int32

Исходный размер внутреннего массива в байтах.The initial size of the internal array in bytes.

Исключения

capacity является отрицательным значением.capacity is negative.

Примеры

Этот пример кода является частью большого примера, приведенного для класса MemoryStream.This code example is part of a larger example provided for the MemoryStream class.

MemoryStream^ memStream = gcnew MemoryStream( 100 );
using(MemoryStream memStream = new MemoryStream(100))
Dim memStream As New MemoryStream(100)

Комментарии

Свойства CanRead, CanSeekи CanWrite имеют значение true.The CanRead, CanSeek, and CanWrite properties are all set to true.

Емкость автоматически увеличивается при использовании метода SetLength, чтобы задать для длины значение, превышающее емкость текущего потока.The capacity automatically increases when you use the SetLength method to set the length to a value larger than the capacity of the current stream. За исключением MemoryStream, созданных с помощью параметра Byte [], операции записи в конце MemoryStream развернуть MemoryStream.Except for a MemoryStream constructed with a byte[] parameter, write operations at the end of a MemoryStream expand the MemoryStream.

Этот конструктор предоставляет базовый поток, который GetBuffer возвращает.This constructor exposes the underlying stream that GetBuffer returns.

Дополнительно

MemoryStream(Byte[], Boolean)

Инициализирует новый неизменяемый экземпляр класса MemoryStream на основе указанного массива байтов с помощью указанного значения свойства CanWrite.Initializes a new non-resizable instance of the MemoryStream class based on the specified byte array with the CanWrite property set as specified.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, bool writable);
public MemoryStream (byte[] buffer, bool writable);
new System.IO.MemoryStream : byte[] * bool -> System.IO.MemoryStream
Public Sub New (buffer As Byte(), writable As Boolean)

Параметры

buffer
Byte[]

Массив байтов без знака, из которого создается данный поток.The array of unsigned bytes from which to create this stream.

writable
Boolean

Параметр свойства CanWrite, который определяет возможность поддержки потоком записи.The setting of the CanWrite property, which determines whether the stream supports writing.

Исключения

Свойство buffer имеет значение null.buffer is null.

Комментарии

Для свойств CanRead и CanSeek задано значение true.The CanRead and CanSeek properties are both set to true. для Capacity задана длина указанного массива байтов.Capacity is set to the length of the specified byte array.

Длина потока не может быть больше начальной длины указанного массива байтов; Однако поток можно усечь (см. SetLength).The length of the stream cannot be set to a value greater than the initial length of the specified byte array; however, the stream can be truncated (see SetLength).

Этот конструктор не предоставляет базовый поток.This constructor does not expose the underlying stream. GetBuffer выдает UnauthorizedAccessException.GetBuffer throws UnauthorizedAccessException.

Дополнительно

MemoryStream(Byte[], Int32, Int32)

Инициализирует новый неизменяемый экземпляр класса MemoryStream на основе указанной области (индекса) массива байтов.Initializes a new non-resizable instance of the MemoryStream class based on the specified region (index) of a byte array.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count);
public MemoryStream (byte[] buffer, int index, int count);
new System.IO.MemoryStream : byte[] * int * int -> System.IO.MemoryStream
Public Sub New (buffer As Byte(), index As Integer, count As Integer)

Параметры

buffer
Byte[]

Массив байтов без знака, из которого создается данный поток.The array of unsigned bytes from which to create this stream.

index
Int32

Индекс в buffer, с которого начинается поток.The index into buffer at which the stream begins.

count
Int32

Длина потока в байтах.The length of the stream in bytes.

Исключения

Свойство buffer имеет значение null.buffer is null.

Значение параметра index или count меньше нуля.index or count is less than zero.

Длина буфера минус index меньше count.The buffer length minus index is less than count.

Комментарии

Свойства CanRead, CanSeekи CanWrite имеют значение true, но емкость не может быть изменена.The CanRead, CanSeek, and CanWrite properties are all set to true, but the capacity cannot be changed. Capacity задан как count.Capacity is set to count.

Длина потока не может быть больше начальной длины указанного массива байтов; Однако поток можно усечь (см. SetLength).The length of the stream cannot be set to a value greater than the initial length of the specified byte array; however, the stream can be truncated (see SetLength).

Этот конструктор не предоставляет базовый поток.This constructor does not expose the underlying stream. GetBuffer выдает UnauthorizedAccessException.GetBuffer throws UnauthorizedAccessException. Однако можно выполнить запись в поток.However, you can write to the stream.

Дополнительно

MemoryStream(Byte[], Int32, Int32, Boolean)

Инициализирует новый неизменяемый экземпляр класса MemoryStream на основе указанной области массива байтов с помощью указанного значения свойства CanWrite.Initializes a new non-resizable instance of the MemoryStream class based on the specified region of a byte array, with the CanWrite property set as specified.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count, bool writable);
public MemoryStream (byte[] buffer, int index, int count, bool writable);
new System.IO.MemoryStream : byte[] * int * int * bool -> System.IO.MemoryStream
Public Sub New (buffer As Byte(), index As Integer, count As Integer, writable As Boolean)

Параметры

buffer
Byte[]

Массив байтов без знака, из которого создается данный поток.The array of unsigned bytes from which to create this stream.

index
Int32

Индекс в buffer, с которого начинается поток.The index in buffer at which the stream begins.

count
Int32

Длина потока в байтах.The length of the stream in bytes.

writable
Boolean

Параметр свойства CanWrite, который определяет возможность поддержки потоком записи.The setting of the CanWrite property, which determines whether the stream supports writing.

Исключения

Свойство buffer имеет значение null.buffer is null.

Параметр index или count имеет отрицательное значение.index or count are negative.

Длина буфера минус index меньше count.The buffer length minus index is less than count.

Комментарии

Для свойств CanRead и CanSeek задано значение true.The CanRead and CanSeek properties are both set to true. Capacity задан как count.Capacity is set to count.

Длина потока не может быть больше начальной длины указанного массива байтов; Однако поток можно усечь (см. SetLength).The length of the stream cannot be set to a value greater than the initial length of the specified byte array; however, the stream can be truncated (see SetLength).

Этот конструктор не предоставляет базовый поток.This constructor does not expose the underlying stream. GetBuffer выдает UnauthorizedAccessException.GetBuffer throws UnauthorizedAccessException. Однако можно выполнить запись в поток, если writable true.However, you can write to the stream if writable is true.

Дополнительно

MemoryStream(Byte[], Int32, Int32, Boolean, Boolean)

Инициализирует новый экземпляр класса MemoryStream на основе указанной области массива байтов с помощью указанного значения свойства CanWrite и возможности вызова GetBuffer() с указанным значением.Initializes a new instance of the MemoryStream class based on the specified region of a byte array, with the CanWrite property set as specified, and the ability to call GetBuffer() set as specified.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count, bool writable, bool publiclyVisible);
public MemoryStream (byte[] buffer, int index, int count, bool writable, bool publiclyVisible);
new System.IO.MemoryStream : byte[] * int * int * bool * bool -> System.IO.MemoryStream
Public Sub New (buffer As Byte(), index As Integer, count As Integer, writable As Boolean, publiclyVisible As Boolean)

Параметры

buffer
Byte[]

Массив байтов без знака, из которого создается данный поток.The array of unsigned bytes from which to create this stream.

index
Int32

Индекс в buffer, с которого начинается поток.The index into buffer at which the stream begins.

count
Int32

Длина потока в байтах.The length of the stream in bytes.

writable
Boolean

Параметр свойства CanWrite, который определяет возможность поддержки потоком записи.The setting of the CanWrite property, which determines whether the stream supports writing.

publiclyVisible
Boolean

Значение true, чтобы разрешить метод GetBuffer(), возвращающий массив байтов без знака, из которого создан поток; в противном случае — значение false.true to enable GetBuffer(), which returns the unsigned byte array from which the stream was created; otherwise, false.

Исключения

Свойство buffer имеет значение null.buffer is null.

index или count является отрицательным значением.index or count is negative.

Длина буфера минус index меньше count.The buffer length minus index is less than count.

Комментарии

Для свойств CanRead и CanSeek задано значение true.The CanRead and CanSeek properties are both set to true. Capacity задан как count.Capacity is set to count.

Новый экземпляр потока может быть записан в, но Capacity базового массива байтов изменить нельзя.The new stream instance can be written to, but the Capacity of the underlying byte array cannot be changed. Длина потока не может быть больше начальной длины указанного массива байтов; Однако поток можно усечь (см. SetLength).The length of the stream cannot be set to a value greater than the initial length of the specified byte array; however, the stream can be truncated (see SetLength).

Дополнительно

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