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

Definizione

Inizia un'operazione di scrittura asincrona. Si consiglia di usare WriteAsync(Byte[], Int32, Int32, CancellationToken).

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);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object? state);
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 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 che rappresenta la scrittura asincrona che può essere ancora in sospeso.

Eccezioni

La lunghezza dibuffer meno 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 le operazioni asincrone sui file.

EndWrite deve essere chiamato esattamente una volta su ogni IAsyncResult da BeginWrite. EndWrite verrà bloccato fino al completamento dell'operazione di I/O.

Si applica a