MemoryStream.Write Метод

Определение

Пространство имен:

System.IO

Сборки:

netstandard.dll, System.Runtime.dll

Перегрузки

Имя	Описание
Write(ReadOnlySpan<Byte>)	Записывает последовательность байтов, содержащихся в source текущем потоке памяти, и перемещает текущую позицию в этом потоке памяти по количеству записанных байтов.
Write(Byte[], Int32, Int32)	Записывает блок байтов в текущий поток с помощью данных, считываемых из буфера.

Write(ReadOnlySpan<Byte>)

Исходный код:

MemoryStream.cs

Записывает последовательность байтов, содержащихся в source текущем потоке памяти, и перемещает текущую позицию в этом потоке памяти по количеству записанных байтов.

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);

public override void Write(ReadOnlySpan<byte> buffer);

override this.Write : ReadOnlySpan<byte> -> unit

Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

Параметры

buffer

ReadOnlySpan<Byte>

Область памяти. Этот метод копирует содержимое этого региона в текущий поток памяти.

Write(Byte[], Int32, Int32)

Исходный код:

MemoryStream.cs

Записывает блок байтов в текущий поток с помощью данных, считываемых из буфера.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public override void Write(byte[] buffer, int offset, int count);

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Параметры

buffer

Byte[]

Буфер для записи данных из.

offset

Int32

Отсчитываемое от нуля смещение байтов, с buffer которого начинается копирование байтов в текущий поток.

count

Int32

Максимальное число байтов для записи.

Исключения

ArgumentNullException

buffer равно null.

NotSupportedException

Поток не поддерживает запись. Дополнительные сведения см. в CanWrite.

–или–

Текущая позиция ближе, чем count байты к концу потока, и емкость не может быть изменена.

ArgumentException

offset Вычитается из длины буфера меньше count.

ArgumentOutOfRangeException

offset или count отрицательные.

IOException

Возникает ошибка ввода-вывода.

ObjectDisposedException

Текущий экземпляр потока закрыт.

Примеры

Этот пример кода является частью более крупного примера, предоставленного для MemoryStream класса.

// Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length);

' Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length)

Комментарии

Этот метод переопределяет метод Write.

Параметр offset дает смещение первого байта для buffer записи, и count параметр дает количество байтов для записи. Если операция записи выполнена успешно, текущая позиция в потоке будет расширена по количеству записанных байтов. Если возникает исключение, текущая позиция в потоке не изменяется.

За исключением созданного MemoryStream с параметром byte[] операции записи в конце MemoryStream расширения MemoryStream.

См. также раздел

• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл