PipeStream.Write Метод

Определение

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

System.IO.Pipes

Сборка:

System.IO.Pipes.dll

Перегрузки

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

Write(ReadOnlySpan<Byte>)

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

PipeStream.Unix.cs

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

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>

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

Исключения

NotSupportedException

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

ObjectDisposedException

Не удается получить доступ к закрытому каналу.

IOException

Канал неисправен.

InvalidOperationException

Канал еще не подключен.

-или-

Канал находится в отключенном состоянии.

-или-

Дескриптор канала не был задан. (Ваша реализация PipeStream вызвала InitializeHandle(SafePipeHandle, Boolean, Boolean)?

Комментарии

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

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

Write(Byte[], Int32, Int32)

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

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);

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.

ArgumentOutOfRangeException

Значение параметраoffset меньше 0.

-или-

Значение параметраcount меньше 0.

ArgumentException

count больше, чем число байтов, доступных в buffer.

ObjectDisposedException

Канал закрыт.

NotSupportedException

Канал не поддерживает операции записи.

IOException

Канал разорван, или возникла другая ошибка ввода-вывода.

Комментарии

Используйте свойство , CanWrite чтобы определить, поддерживает ли текущий PipeStream объект операции записи.

Асинхронные операции записи см. в разделах BeginWrite и EndWrite.