Stream.Write Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
| Write(ReadOnlySpan<Byte>) |
При переопределении в производном классе записывает последовательность байтов в текущий поток и перемещает текущую позицию в нем вперед на число записанных байтов. |
| Write(Byte[], Int32, Int32) |
При переопределении в производном классе записывает последовательность байтов в текущий поток и перемещает текущую позицию в нем вперед на число записанных байтов. |
- Исходный код:
- Stream.cs
- Исходный код:
- Stream.cs
- Исходный код:
- 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> -> unitPublic Overridable Sub Write (buffer As ReadOnlySpan(Of Byte))Параметры
- buffer
- ReadOnlySpan<Byte>
Область памяти. Этот метод копирует содержимое данной области в текущий поток.
Комментарии
Используйте свойство , CanWrite чтобы определить, поддерживает ли текущий экземпляр запись. Используйте метод для WriteAsync асинхронной записи в текущий поток.
Если операция записи выполнена успешно, позиция в потоке увеличивается на количество записанных байтов. Если возникает исключение, позиция в потоке остается неизменной.
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Standard | 2.1 |
- Исходный код:
- Stream.cs
- Исходный код:
- Stream.cs
- Исходный код:
- 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 -> unitPublic MustOverride Sub Write (buffer As Byte(), offset As Integer, count As Integer)Параметры
- buffer
- Byte[]
Массив байтов. Этот метод копирует байты count из buffer в текущий поток.
- offset
- Int32
Отсчитываемое от нуля смещение байтов в буфере buffer, с которого начинается копирование байтов в текущий поток.
- count
- Int32
Количество байтов, которое необходимо записать в текущий поток.
Исключения
Сумма offset и count больше, чем длина буфера.
buffer имеет значение null.
offset или count является отрицательным значением.
Произошла ошибка ввода-вывода, например связанная с тем, что не удается найти указанный файл.
Поток не поддерживает запись.
Метод Write(Byte[], Int32, Int32) был вызван после закрытия потока.
Комментарии
Используйте свойство , CanWrite чтобы определить, поддерживает ли текущий экземпляр запись. Используйте метод для WriteAsync асинхронной записи в текущий поток.
Если операция записи выполнена успешно, позиция в потоке увеличивается на количество записанных байтов. Если возникает исключение, позиция в потоке остается неизменной.
См. также раздел
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: