PipeStream.Write Método

Definição

Namespace:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Assembly:

netstandard.dll

Assembly:

System.Core.dll

Sobrecargas

Write(ReadOnlySpan<Byte>)	Grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo pelo número de bytes gravados.
Write(Byte[], Int32, Int32)	Grava um bloco de bytes no fluxo atual usando os dados de um buffer.

Write(ReadOnlySpan<Byte>)

Grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo pelo número de bytes gravados.

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

Parâmetros

buffer

ReadOnlySpan<Byte>

Uma região da memória. Esse método copia o conteúdo desta região para o fluxo atual.

Exceções

NotSupportedException

Não há suporte para gravação no fluxo.

ObjectDisposedException

Não é possível acessar um pipe fechado.

IOException

O pipe está quebrado.

InvalidOperationException

O pipe ainda não foi conectado.

- ou -

O pipe está em um estado desconectado.

- ou -

O identificador de pipe não foi definido. (A implementação de PipeStream chamou InitializeHandle(SafePipeHandle, Boolean, Boolean)?)

Comentários

Use a CanWrite propriedade para determinar se a instância atual dá suporte à gravação. Use o WriteAsync método para gravar de forma assíncrona no fluxo atual.

Se a operação de gravação for bem-sucedida, a posição dentro do fluxo avançará pelo número de bytes gravados. Se ocorrer uma exceção, a posição dentro do fluxo permanecerá inalterada.

Write(Byte[], Int32, Int32)

Grava um bloco de bytes no fluxo atual usando os dados de um buffer.

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 -> unit

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

Parâmetros

buffer

Byte[]

O buffer que contém dados a gravar no pipe.

offset

Int32

O deslocamento de bytes baseado em zero em buffer no qual será iniciada a cópia de bytes no fluxo atual.

count

Int32

O número máximo de bytes a gravar no fluxo atual.

Atributos

SecurityCriticalAttribute

Exceções

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

offset é menor que 0.

- ou - count é menor que 0.

ArgumentException

count é maior que o número de bytes disponível no buffer.

ObjectDisposedException

O pipe está fechado.

NotSupportedException

O pipe não dá suporte a operações de gravação.

IOException

O pipe está interrompido ou ocorreu outro erro de E/S.

Comentários

Use a CanWrite propriedade para determinar se o objeto atual PipeStream dá suporte a operações de gravação.

Para operações de gravação assíncronas, consulte BeginWrite e EndWrite.