PipeStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inizia 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 che contiene i dati da scrivere nel flusso corrente.
- offset
- Int32
Offset dei byte in base zero in buffer
da cui iniziare la copia dei byte nel flusso corrente.
- count
- Int32
Numero massimo di byte da scrivere.
- callback
- AsyncCallback
Metodo da chiamare quando l'operazione di scrittura asincrona viene completata.
- state
- Object
Oggetto fornito dall'utente che distingue questa specifica richiesta di scrittura asincrona da altre richieste.
Restituisce
Oggetto IAsyncResult che fa riferimento all'operazione di scrittura asincrona.
- Attributi
Eccezioni
buffer
è null
.
count
è maggiore del numero di byte disponibili in buffer
.
La pipe è chiusa.
La pipe non supporta operazioni di scrittura.
Pipe disconnessa, in attesa di connessione oppure handle non impostato.
Pipe danneggiata oppure errore di I/O.
Commenti
EndWrite deve essere chiamato una sola volta per ogni chiamata a BeginWrite. Questa operazione può essere eseguita nello stesso codice 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 un argomento non valido viene passato a BeginWrite, vengono generate immediatamente le eccezioni appropriate. 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.