PipeStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicia uma operação de escrita assíncrona.
public:
override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);public override IAsyncResult BeginWrite(byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);public override IAsyncResult BeginWrite(byte[] buffer, int offset, int count, AsyncCallback callback, object state);[System.Security.SecurityCritical]
public override IAsyncResult BeginWrite(byte[] buffer, int offset, int count, AsyncCallback callback, object state);override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult[<System.Security.SecurityCritical>]
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResultPublic Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResultParâmetros
- buffer
- Byte[]
O buffer que contém os dados a escrever no fluxo atual.
- offset
- Int32
O deslocamento de bytes baseado em zero em buffer que se deve começar a copiar bytes para o fluxo atual.
- count
- Int32
O número máximo de bytes a escrever.
- callback
- AsyncCallback
O método a chamar quando a operação de escrita assíncrona está concluída.
- state
- Object
Um objeto fornecido pelo utilizador que distingue este pedido de escrita assíncrono particular de outros pedidos.
Devoluções
Um IAsyncResult objeto que faz referência à operação de escrita assíncrona.
- Atributos
Exceções
buffer é null.
count é maior do que o número de bytes disponíveis em buffer.
O tubo está fechado.
O pipeline não suporta operações de escrita.
O tubo está desligado, à espera de ser ligado, ou a maçaneta não foi ajustada.
O tubo está partido ou ocorreu outro erro de E/S.
Observações
EndWrite deve ser chamada uma vez por cada chamada para BeginWrite. Isto pode ser feito no mesmo código que chamou BeginWrite ou num callback que é passado para BeginWrite.
Use a CanWrite propriedade para determinar se o objeto atual PipeStream suporta operações de escrita.
Se o tubo for fechado ou um argumento inválido for passado para BeginWrite, as exceções apropriadas são levantadas imediatamente. Erros que ocorrem durante um pedido de escrita assíncrona ocorrem no thread pool que está a executar o pedido. As exceções são levantadas quando o código chama o EndWrite método.
