Stream.Write Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

Перегрузки

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

Write(ReadOnlySpan<Byte>)

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

Stream.cs

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

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

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

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

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

Параметры

buffer

ReadOnlySpan<Byte>

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

Комментарии

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

Если операция записи выполнена успешно, позиция в потоке увеличивается на количество записанных байтов. Если возникает исключение, позиция в потоке остается неизменной.

Write(Byte[], Int32, Int32)

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

Stream.cs

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

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

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

abstract member Write : byte[] * int * int -> unit

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

Параметры

buffer

Byte[]

Массив байтов. Этот метод копирует байты count из buffer в текущий поток.

offset

Int32

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

count

Int32

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

Исключения

ArgumentException

Сумма offset и count больше, чем длина буфера.

ArgumentNullException

buffer имеет значение null.

ArgumentOutOfRangeException

offset или count является отрицательным значением.

IOException

Произошла ошибка ввода-вывода, например связанная с тем, что не удается найти указанный файл.

NotSupportedException

Поток не поддерживает запись.

ObjectDisposedException

Метод Write(Byte[], Int32, Int32) был вызван после закрытия потока.

Комментарии

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

Если операция записи выполнена успешно, позиция в потоке увеличивается на количество записанных байтов. Если возникает исключение, позиция в потоке остается неизменной.

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

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