PipeStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.
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.