Språk

PipeStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Metod

Definition

Påbörjar en asynkron läsåtgärd.

public:
 override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);
public override IAsyncResult BeginRead(byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);
public override IAsyncResult BeginRead(byte[] buffer, int offset, int count, AsyncCallback callback, object state);
[System.Security.SecurityCritical]
public override IAsyncResult BeginRead(byte[] buffer, int offset, int count, AsyncCallback callback, object state);
override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
[<System.Security.SecurityCritical>]
override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overrides Function BeginRead (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

buffer
Byte[]

Bufferten som data ska läsas in i.

offset
Int32

Byteförskjutningen som du vill börja läsa i buffer .

count
Int32

Det maximala antalet byte som ska läsas.

callback
AsyncCallback

Den metod som ska anropas när den asynkrona läsåtgärden har slutförts.

state
Object

Ett objekt som tillhandahålls av användaren och som skiljer den här specifika asynkrona läsbegäran från andra begäranden.

Returer

Ett IAsyncResult objekt som refererar till den asynkrona läsningen.

Attribut

Undantag

buffer är null.

offset är mindre än 0.

-eller-

count är mindre än 0.

count är större än antalet tillgängliga byte i buffer.

Röret är stängt.

Röret stöder inte läsåtgärder.

Röret är frånkopplat, väntar på att ansluta, eller så har handtaget inte ställts in.

Röret är trasigt eller så uppstod ett annat I/O-fel.

Kommentarer

Skicka det returnerade IAsyncResult objektet till EndRead metoden för att fastställa hur många byte som lästes och för att frigöra operativsystemresurser som används för läsning. EndRead måste anropas en gång för varje anrop till BeginRead. Detta kan göras antingen i samma kod som anropade BeginRead eller i ett återanrop som skickas till BeginRead.

Använd egenskapen CanRead för att avgöra om det aktuella PipeStream objektet stöder läsåtgärder.

Om röret stängs eller ett ogiltigt argument skickas till BeginReadgenereras lämpliga undantag omedelbart. Fel som uppstår under en asynkron läsbegäran inträffar i trådpoolstråden som utför begäran. Undantagen utlöses när koden anropar EndRead metoden.

Gäller för