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

Definice

Obor názvů:

System.IO.Pipes

Sestavení:

netstandard.dll, System.IO.Pipes.dll

Zdroj:

PipeStream.Unix.cs

Zahájí asynchronní operaci zápisu.

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

Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parametry

buffer

Byte[]

Vyrovnávací paměť obsahující data, která se mají zapisovat do aktuálního datového proudu.

offset

Int32

Posun bajtů založený na nule, při buffer kterém se mají začít kopírovat bajty do aktuálního datového proudu.

count

Int32

Maximální počet bajtů k zápisu.

callback

AsyncCallback

Metoda, která se má volat při dokončení asynchronní operace zápisu.

state

Object

Objekt poskytovaný uživatelem, který rozlišuje tento konkrétní asynchronní požadavek zápisu od jiných požadavků.

Návraty

IAsyncResult

Objekt IAsyncResult , který odkazuje na asynchronní operaci zápisu.

Výjimky

ArgumentNullException

buffer je null.

ArgumentOutOfRangeException

offset je menší než 0.

nebo

count je menší než 0.

ArgumentException

count je větší než počet bajtů dostupných v buffer.

ObjectDisposedException

Potrubí je uzavřeno.

NotSupportedException

Kanál nepodporuje operace zápisu.

InvalidOperationException

Kanál je odpojený, čeká na připojení nebo nebyl nastaven popisovač.

IOException

Kanál je poškozený nebo došlo k jiné vstupně-výstupní chybě.

Poznámky

EndWrite musí být volána jednou pro každé volání BeginWrite. To lze provést buď ve stejném kódu, který volal BeginWrite , nebo v zpětném volání, který je předán BeginWrite.

CanWrite Pomocí vlastnosti určete, zda aktuální PipeStream objekt podporuje operace zápisu.

Pokud je potrubí uzavřeno nebo je předán BeginWriteneplatný argument , příslušné výjimky jsou vyvolány okamžitě. Chyby, ke kterým dochází během asynchronního požadavku na zápis, dochází ve vlákně fondu vláken, které požadavek provádí. Výjimky jsou vyvolány při volání EndWrite kódu metody.