Socket.BeginReceive Metod

Definition

Namnområde:: System.Net.Sockets

Sammansättningar:: netstandard.dll, System.Net.Sockets.dll

Sammansättning:: System.Net.Sockets.dll

Sammansättning:: System.dll

Sammansättning:: netstandard.dll

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.

Börjar asynkront ta emot data från en ansluten Socket.

Överlagringar

Name	Description
BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)	Börjar asynkront ta emot data från en ansluten Socket.
BeginReceive(Byte[], Int32, Int32, SocketFlags, SocketError, AsyncCallback, Object)	Börjar asynkront ta emot data från en ansluten Socket.
BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, AsyncCallback, Object)	Börjar asynkront ta emot data från en ansluten Socket.
BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, SocketError, AsyncCallback, Object)	Börjar asynkront ta emot data från en ansluten Socket.

BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Börjar asynkront ta emot data från en ansluten Socket.

public:
 IAsyncResult ^ BeginReceive(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReceive(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, AsyncCallback? callback, object? state);

public IAsyncResult BeginReceive(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, AsyncCallback callback, object state);

member this.BeginReceive : byte[] * int * int * System.Net.Sockets.SocketFlags * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, callback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

buffer: Byte[]

En matris av typen Byte som är lagringsplats för mottagna data.

offset: Int32

Den nollbaserade positionen i parametern buffer där mottagna data ska lagras.

size: Int32

Antalet byte som ska ta emot.

socketFlags: SocketFlags

En bitvis kombination av SocketFlags värdena.

callback: AsyncCallback

Ett AsyncCallback ombud som refererar till den metod som ska anropas när åtgärden är klar.

state: Object

Ett användardefinierat objekt som innehåller information om mottagningsåtgärden. Det här objektet skickas till ombudet EndReceive(IAsyncResult) när åtgärden är klar.

Returer

IAsyncResult

En IAsyncResult som refererar till den asynkrona läsningen.

Undantag

ArgumentNullException

buffer är null.

SocketException

endast .NET Framework: Ett fel uppstod vid försök att komma åt socketen.

ObjectDisposedException

Socket har stängts.

ArgumentOutOfRangeException

offset är mindre än 0.

-eller-

offset är större än längden på buffer.

-eller-

size är mindre än 0.

-eller-

size är större än längden buffer på minus värdet för parametern offset .

Kommentarer

Important

Det här är ett kompatibilitets-API. Vi rekommenderar inte att du använder APM-metoderna (Begin* och End*) för ny utveckling. Använd i stället de Task-baserade motsvarigheterna.

Du kan skicka ett återanrop som implementeras AsyncCallback till BeginReceive för att få ett meddelande om att åtgärden har slutförts. Observera att om den underliggande nätverksstacken slutför åtgärden synkront körs återanropet infogat under anropet till BeginReceive. I det här fallet CompletedSynchronously anges egenskapen för den returnerade IAsyncResult till för true att indikera att metoden slutfördes synkront. AsyncState Använd egenskapen för IAsyncResult att hämta tillståndsobjektet som skickas BeginReceive till metoden.

Den asynkrona BeginReceive åtgärden måste slutföras genom att anropa EndReceive metoden. Metoden anropas vanligtvis av ombudet AsyncCallback . EndReceive blockerar den anropande tråden tills åtgärden har slutförts.

Stäng för Socket att avbryta en väntande BeginReceive. Close När metoden anropas medan en asynkron åtgärd pågår anropas återanropet BeginReceive till metoden. Ett efterföljande anrop till metoden EndReceive genererar en ObjectDisposedException (före .NET 7) eller en SocketException (på .NET 7+) för att indikera att åtgärden har avbrutits.

Note

Om du får en SocketExceptionanvänder du SocketException.ErrorCode egenskapen för att hämta den specifika felkoden.

Note

Alla I/O som initieras av en viss tråd avbryts när tråden avslutas. En väntande asynkron åtgärd kan misslyckas om tråden avslutas innan åtgärden slutförs.

Note

state är en instansiering av en användardefinierad klass.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.

Note

Körningskontexten (säkerhetskontexten, den personifierade användaren och den anropande kontexten) cachelagras för de asynkrona Socket metoderna. Efter den första användningen av en viss kontext (en specifik asynkron Socket metod, en specifik Socket instans och en specifik motringning) kommer efterföljande användning av den kontexten att se en prestandaförbättring.

Se även

Gäller för

BeginReceive(Byte[], Int32, Int32, SocketFlags, SocketError, AsyncCallback, Object)

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Börjar asynkront ta emot data från en ansluten Socket.

public:
 IAsyncResult ^ BeginReceive(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult? BeginReceive(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode, AsyncCallback? callback, object? state);

public IAsyncResult BeginReceive(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode, AsyncCallback callback, object state);

member this.BeginReceive : byte[] * int * int * System.Net.Sockets.SocketFlags * SocketError * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, ByRef errorCode As SocketError, callback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

buffer: Byte[]

En matris av typen Byte som är lagringsplats för mottagna data.

offset: Int32

Platsen där buffer de mottagna data ska lagras.

size: Int32

Antalet byte som ska ta emot.

socketFlags: SocketFlags

En bitvis kombination av SocketFlags värdena.

errorCode: SocketError

Ett SocketError objekt som lagrar socketfelet.

callback: AsyncCallback

Ett AsyncCallback ombud som refererar till den metod som ska anropas när åtgärden är klar.

state: Object

Ett användardefinierat objekt som innehåller information om mottagningsåtgärden. Det här objektet skickas till ombudet EndReceive(IAsyncResult) när åtgärden är klar.

Returer

IAsyncResult

En IAsyncResult som refererar till den asynkrona läsningen.

Undantag

ArgumentNullException

buffer är null.

SocketException

endast .NET Framework: Ett fel uppstod vid försök att komma åt socketen.

ObjectDisposedException

Socket har stängts.

ArgumentOutOfRangeException

offset är mindre än 0.

-eller-

offset är större än längden på buffer.

-eller-

size är mindre än 0.

-eller-

size är större än längden buffer på minus värdet för parametern offset .

Kommentarer

Important

Det här är ett kompatibilitets-API. Vi rekommenderar inte att du använder APM-metoderna (Begin* och End*) för ny utveckling. Använd i stället de Task-baserade motsvarigheterna.

Note

Om du får en SocketExceptionanvänder du SocketException.ErrorCode egenskapen för att hämta den specifika felkoden.

Note

Alla I/O som initieras av en viss tråd avbryts när tråden avslutas. En väntande asynkron åtgärd kan misslyckas om tråden avslutas innan åtgärden slutförs.

Note

state är en instansiering av en användardefinierad klass.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.

Note

Se även

Gäller för

BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, AsyncCallback, Object)

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Börjar asynkront ta emot data från en ansluten Socket.

public:
 IAsyncResult ^ BeginReceive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReceive(System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags, AsyncCallback? callback, object? state);

public IAsyncResult BeginReceive(System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags, AsyncCallback callback, object state);

member this.BeginReceive : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags, callback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

buffers: IList<ArraySegment<Byte>>

En matris av typen Byte som är lagringsplats för mottagna data.

socketFlags: SocketFlags

En bitvis kombination av SocketFlags värdena.

callback: AsyncCallback

Ett AsyncCallback ombud som refererar till den metod som ska anropas när åtgärden är klar.

state: Object

Ett användardefinierat objekt som innehåller information om mottagningsåtgärden. Det här objektet skickas till ombudet EndReceive(IAsyncResult) när åtgärden är klar.

Returer

IAsyncResult

En IAsyncResult som refererar till den asynkrona läsningen.

Undantag

ArgumentNullException

buffers är null.

SocketException

endast .NET Framework: Ett fel uppstod vid försök att komma åt socketen.

ObjectDisposedException

Socket har stängts.

Kommentarer

Important

Det här är ett kompatibilitets-API. Vi rekommenderar inte att du använder APM-metoderna (Begin* och End*) för ny utveckling. Använd i stället de Task-baserade motsvarigheterna.

Note

Om du får en SocketExceptionanvänder du SocketException.ErrorCode egenskapen för att hämta den specifika felkoden.

Note

Alla I/O som initieras av en viss tråd avbryts när tråden avslutas. En väntande asynkron åtgärd kan misslyckas om tråden avslutas innan åtgärden slutförs.

Note

state är en instansiering av en användardefinierad klass.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.

Note

Se även

Gäller för

BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, SocketError, AsyncCallback, Object)

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Börjar asynkront ta emot data från en ansluten Socket.

public:
 IAsyncResult ^ BeginReceive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult? BeginReceive(System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode, AsyncCallback? callback, object? state);

public IAsyncResult BeginReceive(System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode, AsyncCallback callback, object state);

member this.BeginReceive : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags * SocketError * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags, ByRef errorCode As SocketError, callback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

buffers: IList<ArraySegment<Byte>>

En matris av typen Byte som är lagringsplats för mottagna data.

socketFlags: SocketFlags

En bitvis kombination av SocketFlags värdena.

errorCode: SocketError

Ett SocketError objekt som lagrar socketfelet.

callback: AsyncCallback

Ett AsyncCallback ombud som refererar till den metod som ska anropas när åtgärden är klar.

state: Object

Ett användardefinierat objekt som innehåller information om mottagningsåtgärden. Det här objektet skickas till ombudet EndReceive(IAsyncResult) när åtgärden är klar.

Returer

IAsyncResult

En IAsyncResult som refererar till den asynkrona läsningen.

Undantag

ArgumentNullException

buffers är null.

SocketException

endast .NET Framework: Ett fel uppstod vid försök att komma åt socketen.

ObjectDisposedException

Socket har stängts.

Kommentarer

Important

Det här är ett kompatibilitets-API. Vi rekommenderar inte att du använder APM-metoderna (Begin* och End*) för ny utveckling. Använd i stället de Task-baserade motsvarigheterna.

Note

Om du får en SocketExceptionanvänder du SocketException.ErrorCode egenskapen för att hämta den specifika felkoden.

Note

Alla I/O som initieras av en viss tråd avbryts när tråden avslutas. En väntande asynkron åtgärd kan misslyckas om tråden avslutas innan åtgärden slutförs.

Note

state är en instansiering av en användardefinierad klass.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.

Note

Se även

Gäller för

Feedback

Var den här sidan till hjälp?