Sdílet prostřednictvím


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

Definice

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);
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

Parametry

buffer
Byte[]

Vyrovnávací paměť, která obsahuje data pro zápis do aktuálního datového proudu.

offset
Int32

Posun od nuly bajtů, při buffer kterém se má 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 volání při dokončení asynchronní operace zápisu.

state
Object

Uživatelem zadaný objekt, který odlišuje tento konkrétní asynchronní požadavek na zápis od ostatních požadavků.

Návraty

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

Atributy

Výjimky

buffer je null.

offset je menší než 0.

-nebo-

count je menší než 0.

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

Potrubí je zavřené.

Kanál nepodporuje operace zápisu.

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

Kanál je přerušený nebo došlo k jiné vstupně-výstupní chybě.

Poznámky

EndWritemusí 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 ve zpětném volání, které je předáno do BeginWrite.

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

Pokud je kanál uzavřen nebo je předán neplatný argument do BeginWrite, 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, se vyskytují ve vlákně fondu vláken, které provádí požadavek. Výjimky jsou vyvolány, když kód volá metodu EndWrite .

Platí pro