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

Riferimento

Definizione

Spazio dei nomi:: System.IO

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origine:: BufferedStream.cs

Origine:: BufferedStream.cs

Origine:: BufferedStream.cs

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. 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

IAsyncResult

Oggetto che rappresenta la scrittura asincrona che può essere ancora in sospeso.

Eccezioni

ArgumentException

La lunghezza dibuffer meno offset è minore di count.

ArgumentNullException

buffer è null.

ArgumentOutOfRangeException

offset o count è negativo.

NotSupportedException

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