PipeStream.Write Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Write(ReadOnlySpan<Byte>) |
Записывает последовательность байтов в текущий поток и перемещает текущую позицию внутри потока на число записанных байтов. |
| Write(Byte[], Int32, Int32) |
Записывает в текущий поток блок байтов, используя данные из буфера. |
Write(ReadOnlySpan<Byte>)
- Исходный код:
- PipeStream.Unix.cs
- Исходный код:
- PipeStream.Unix.cs
- Исходный код:
- PipeStream.Unix.cs
Записывает последовательность байтов в текущий поток и перемещает текущую позицию внутри потока на число записанных байтов.
public:
override void Write(ReadOnlySpan<System::Byte> buffer);public override void Write (ReadOnlySpan<byte> buffer);override this.Write : ReadOnlySpan<byte> -> unitPublic Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))Параметры
- buffer
- ReadOnlySpan<Byte>
Область памяти. Этот метод копирует содержимое данной области в текущий поток.
Исключения
Поток не поддерживает запись.
Не удается получить доступ к закрытому каналу.
Канал неисправен.
Канал еще не подключен.
-или-
Канал находится в отключенном состоянии.
-или-
Дескриптор канала не был задан. (Ваша реализация PipeStream вызвала InitializeHandle(SafePipeHandle, Boolean, Boolean)?
Комментарии
Используйте свойство , CanWrite чтобы определить, поддерживает ли текущий экземпляр запись. Используйте метод для WriteAsync асинхронной записи в текущий поток.
Если операция записи выполнена успешно, позиция в потоке увеличивается на количество записанных байтов. При возникновении исключения позиция в потоке остается неизменной.
Применяется к
Write(Byte[], Int32, Int32)
- Исходный код:
- PipeStream.Unix.cs
- Исходный код:
- PipeStream.Unix.cs
- Исходный код:
- PipeStream.Unix.cs
Записывает в текущий поток блок байтов, используя данные из буфера.
public:
override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);public override void Write (byte[] buffer, int offset, int count);[System.Security.SecurityCritical]
public override void Write (byte[] buffer, int offset, int count);override this.Write : byte[] * int * int -> unit[<System.Security.SecurityCritical>]
override this.Write : byte[] * int * int -> unitPublic Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)Параметры
- buffer
- Byte[]
Буфер, содержащий данные для записи в канал.
- offset
- Int32
Отсчитываемое от нуля смещение байтов в буфере buffer, с которого начинается копирование байтов в текущий поток.
- count
- Int32
Максимальное число байтов для записи в текущий поток.
- Атрибуты
Исключения
buffer имеет значение null.
Значение параметраoffset меньше 0.
-или-
Значение параметраcount меньше 0.
count больше, чем число байтов, доступных в buffer.
Канал закрыт.
Канал не поддерживает операции записи.
Канал разорван, или возникла другая ошибка ввода-вывода.
Комментарии
Используйте свойство , CanWrite чтобы определить, поддерживает ли текущий PipeStream объект операции записи.
Асинхронные операции записи см. в разделах BeginWrite и EndWrite.
