BufferedStream.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.
Avvia un'operazione di scrittura asincrona. Prendere invece in considerazione l'uso WriteAsync(Byte[], Int32, Int32, CancellationToken) di .
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);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 IAsyncResultParametri
- 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.
Valori restituiti
Oggetto che fa riferimento alla scrittura asincrona, che potrebbe essere ancora in sospeso.
Eccezioni
buffer length minus offset è minore di count.
buffer è null.
offset o count è negativo.
Il flusso non supporta la scrittura.
Commenti
In .NET Framework 4 e versioni precedenti è necessario usare metodi come BeginWrite e EndWrite per implementare operazioni di file asincrone. Questi metodi sono ancora disponibili in .NET Framework 4.5 per supportare il codice legacy; Tuttavia, i nuovi metodi asincroni, ad esempio ReadAsync, WriteAsynce FlushAsync, consentono di implementare più facilmente operazioni di file asincrone.
EndWrite deve essere chiamato esattamente una volta su ogni IAsyncResult da BeginWrite. EndWrite bloccherà fino al completamento dell'operazione di I/O.