Condividi tramite


PipeStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Metodo

Definizione

Avvia un'operazione di scrittura asincrona.

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 -> IAsyncResult
Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parametri

buffer
Byte[]

Buffer contenente i dati da scrivere nel flusso corrente.

offset
Int32

Offset dei byte in base zero in in buffer corrispondenza del quale iniziare a copiare i byte nel flusso corrente.

count
Int32

Numero massimo di byte da scrivere.

callback
AsyncCallback

Metodo da chiamare al termine dell'operazione di scrittura asincrona.

state
Object

Oggetto fornito dall'utente che distingue questa particolare richiesta di scrittura asincrona da altre richieste.

Restituisce

Oggetto IAsyncResult che fa riferimento all'operazione di scrittura asincrona.

Attributi

Eccezioni

buffer è null.

offset è minore di 0.

oppure

count è minore di 0.

count è maggiore del numero di byte disponibili in buffer.

La pipe è chiusa.

La pipe non supporta operazioni di scrittura.

La pipe è disconnessa, in attesa di connessione o l'handle non è stato impostato.

La pipe è interrotta o si è verificato un altro errore di I/O.

Commenti

EndWrite deve essere chiamato una volta per ogni chiamata a BeginWrite. Questa operazione può essere eseguita nello stesso codice che ha chiamato BeginWrite o in un callback passato a BeginWrite.

Utilizzare la CanWrite proprietà per determinare se l'oggetto corrente PipeStream supporta operazioni di scrittura.

Se la pipe viene chiusa o viene passato un argomento non valido a BeginWrite, le eccezioni appropriate vengono generate immediatamente. Gli errori che si verificano durante una richiesta di scrittura asincrona si verificano nel thread del pool di thread che esegue la richiesta. Le eccezioni vengono generate quando il codice chiama il EndWrite metodo .

Si applica a