Stream.Write Метод

Определение

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

System.IO

Сборки:

netstandard.dll, 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 Используйте метод для асинхронной записи в текущий поток.

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

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

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