Socket.BeginAccept 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.

Påbörjar en asynkron åtgärd för att acceptera ett inkommande anslutningsförsök.

Överlagringar

Name	Description
BeginAccept(AsyncCallback, Object)	Påbörjar en asynkron åtgärd för att acceptera ett inkommande anslutningsförsök.
BeginAccept(Int32, AsyncCallback, Object)	Påbörjar en asynkron åtgärd för att acceptera ett inkommande anslutningsförsök och tar emot det första datablocket som skickas av klientprogrammet.
BeginAccept(Socket, Int32, AsyncCallback, Object)	Påbörjar en asynkron åtgärd för att acceptera ett inkommande anslutningsförsök från en angiven socket och tar emot det första datablocket som skickas av klientprogrammet.

BeginAccept(AsyncCallback, Object)

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Påbörjar en asynkron åtgärd för att acceptera ett inkommande anslutningsförsök.

public:
 IAsyncResult ^ BeginAccept(AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginAccept(AsyncCallback? callback, object? state);

public IAsyncResult BeginAccept(AsyncCallback callback, object state);

member this.BeginAccept : AsyncCallback * obj -> IAsyncResult

Public Function BeginAccept (callback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

callback: AsyncCallback

Ombudet AsyncCallback .

state: Object

Ett objekt som innehåller tillståndsinformation för den här begäran.

Returer

IAsyncResult

En IAsyncResult som refererar till den asynkrona Socket skapandet.

Undantag

ObjectDisposedException

Objektet Socket har stängts.

InvalidOperationException

Den accepterande socketen lyssnar inte efter anslutningar. Du måste anropa Bind(EndPoint) och Listen(Int32) innan du ringer BeginAccept(AsyncCallback, Object).

-eller-

Den godkända socketen är bunden.

SocketException

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

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.

Anslutningsorienterade protokoll kan använda BeginAccept metoden för att börja acceptera inkommande anslutningsförsök. Innan du anropar BeginAccept metoden måste du anropa Listen metoden för att lyssna efter och köa inkommande anslutningsbegäranden.

Du kan skicka ett återanrop som implementeras AsyncCallback till BeginAccept för att få ett meddelande om slutförandet av acceptåtgärden. Observera att om den underliggande nätverksstacken slutför åtgärden synkront kan återanropet köras infogat under anropet till BeginAccept. 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 BeginAccept till metoden.

Åtgärden BeginAccept måste slutföras genom att anropa EndAccept metoden. Metoden anropas vanligtvis av det angivna AsyncCallback ombudet. EndAccept blockerar den anropande tråden tills åtgärden har slutförts.

Om du vill avbryta ett väntande anrop till BeginAccept metoden stänger du Socket. Close När metoden anropas medan en asynkron åtgärd pågår anropas återanropet BeginAccept till metoden. Ett efterföljande anrop till metoden EndAccept genererar en ObjectDisposedException (före .NET 7) eller en SocketException (på .NET 7+) för att indikera att åtgärden har avbrutits.

Note

Du kan använda RemoteEndPoint egenskapen för den returnerade Socket för att identifiera fjärrvärdens nätverksadress och portnummer.

Note

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

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

BeginAccept(Int32, AsyncCallback, Object)

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Påbörjar en asynkron åtgärd för att acceptera ett inkommande anslutningsförsök och tar emot det första datablocket som skickas av klientprogrammet.

public:
 IAsyncResult ^ BeginAccept(int receiveSize, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginAccept(int receiveSize, AsyncCallback? callback, object? state);

public IAsyncResult BeginAccept(int receiveSize, AsyncCallback callback, object state);

member this.BeginAccept : int * AsyncCallback * obj -> IAsyncResult

Public Function BeginAccept (receiveSize As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

receiveSize: Int32

Antalet byte som ska accepteras från avsändaren.

callback: AsyncCallback

Ombudet AsyncCallback .

state: Object

Ett objekt som innehåller tillståndsinformation för den här begäran.

Returer

IAsyncResult

En IAsyncResult som refererar till den asynkrona Socket skapandet.

Undantag

ObjectDisposedException

Objektet Socket har stängts.

InvalidOperationException

Den accepterande socketen lyssnar inte efter anslutningar. Du måste anropa Bind(EndPoint) och Listen(Int32) innan du ringer BeginAccept(AsyncCallback, Object).

-eller-

Den godkända socketen är bunden.

ArgumentOutOfRangeException

receiveSize är mindre än 0.

SocketException

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

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

Du kan använda RemoteEndPoint egenskapen för den returnerade Socket för att identifiera fjärrvärdens nätverksadress och portnummer.

Note

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

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

BeginAccept(Socket, Int32, AsyncCallback, Object)

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Källa:: Socket.cs

Påbörjar en asynkron åtgärd för att acceptera ett inkommande anslutningsförsök från en angiven socket och tar emot det första datablocket som skickas av klientprogrammet.

public:
 IAsyncResult ^ BeginAccept(System::Net::Sockets::Socket ^ acceptSocket, int receiveSize, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginAccept(System.Net.Sockets.Socket? acceptSocket, int receiveSize, AsyncCallback? callback, object? state);

public IAsyncResult BeginAccept(System.Net.Sockets.Socket acceptSocket, int receiveSize, AsyncCallback callback, object state);

member this.BeginAccept : System.Net.Sockets.Socket * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginAccept (acceptSocket As Socket, receiveSize As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

acceptSocket: Socket

Det godkända Socket objektet. Det här värdet kan vara null.

receiveSize: Int32

Det maximala antalet byte som ska ta emot.

callback: AsyncCallback

Ombudet AsyncCallback .

state: Object

Ett objekt som innehåller tillståndsinformation för den här begäran.

Returer

IAsyncResult

Ett IAsyncResult objekt som refererar till skapandet av asynkrona Socket objekt.

Undantag

ObjectDisposedException

Objektet Socket har stängts.

InvalidOperationException

Den accepterande socketen lyssnar inte efter anslutningar. Du måste anropa Bind(EndPoint) och Listen(Int32) innan du ringer BeginAccept(AsyncCallback, Object).

-eller-

Den godkända socketen är bunden.

ArgumentOutOfRangeException

receiveSize är mindre än 0.

SocketException

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

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.

Anslutningsorienterade protokoll kan använda BeginAccept metoden för att börja acceptera inkommande anslutningsförsök. Den resulterande acceptåtgärden representeras av den returnerade IAsyncResult trots att den kan slutföras synkront. Innan du anropar BeginAccept metoden måste du anropa Listen metoden för att lyssna efter och köa inkommande anslutningsbegäranden.

Note

Du kan använda RemoteEndPoint egenskapen för den returnerade Socket för att identifiera fjärrvärdens nätverksadress och portnummer.

Note

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

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?