Socket.BeginConnect 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 begäran om en fjärrvärdanslutning.

Överlagringar

Name	Description
BeginConnect(EndPoint, AsyncCallback, Object)	Påbörjar en asynkron begäran om en fjärrvärdanslutning.
BeginConnect(IPAddress, Int32, AsyncCallback, Object)	Påbörjar en asynkron begäran om en fjärrvärdanslutning. Värden anges av ett IPAddress och ett portnummer.
BeginConnect(IPAddress[], Int32, AsyncCallback, Object)	Påbörjar en asynkron begäran om en fjärrvärdanslutning. Värden anges av en IPAddress matris och ett portnummer.
BeginConnect(String, Int32, AsyncCallback, Object)	Påbörjar en asynkron begäran om en fjärrvärdanslutning. Värden anges med ett värdnamn och ett portnummer.

BeginConnect(EndPoint, 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 begäran om en fjärrvärdanslutning.

public:
 IAsyncResult ^ BeginConnect(System::Net::EndPoint ^ remoteEP, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginConnect(System.Net.EndPoint remoteEP, AsyncCallback? callback, object? state);

public IAsyncResult BeginConnect(System.Net.EndPoint remoteEP, AsyncCallback callback, object state);

member this.BeginConnect : System.Net.EndPoint * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (remoteEP As EndPoint, callback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

remoteEP: EndPoint

En EndPoint som representerar fjärrvärden.

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 anslutningen.

Undantag

ArgumentNullException

remoteEP är null.

SocketException

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

ObjectDisposedException

Har Socket stängts.

SecurityException

En anropare högre i anropsstacken har inte behörighet för den begärda åtgärden.

InvalidOperationException

Socket Har placerats i ett lyssningstillstånd genom att anropa Listen(Int32), eller så pågår redan en asynkron åtgärd.

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.

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

BeginConnect(IPAddress, 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 begäran om en fjärrvärdanslutning. Värden anges av ett IPAddress och ett portnummer.

public:
 IAsyncResult ^ BeginConnect(System::Net::IPAddress ^ address, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect(System.Net.IPAddress address, int port, AsyncCallback? requestCallback, object? state);

public IAsyncResult BeginConnect(System.Net.IPAddress address, int port, AsyncCallback requestCallback, object state);

member this.BeginConnect : System.Net.IPAddress * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

address: IPAddress

Fjärrvärdens IPAddress .

port: Int32

Portnumret för fjärrvärden.

requestCallback: AsyncCallback

Ett AsyncCallback ombud som refererar till metoden för att anropa när anslutningsåtgärden är klar.

state: Object

Ett användardefinierat objekt som innehåller information om anslutningsåtgärden. Det här objektet skickas till ombudet requestCallback när åtgärden är klar.

Returer

IAsyncResult

En IAsyncResult som refererar till den asynkrona anslutningen.

Undantag

ArgumentNullException

address är null.

SocketException

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

ObjectDisposedException

Har Socket stängts.

NotSupportedException

Är Socket inte i socket-familjen.

ArgumentOutOfRangeException

Portnumret är inte giltigt.

ArgumentException

Längden address på är noll.

InvalidOperationException

Socket Har placerats i ett lyssningstillstånd genom att anropa Listen(Int32), eller så pågår redan en asynkron åtgärd.

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.

Om du använder ett anslutningsorienterat protokoll BeginConnect startar metoden en asynkron begäran om en anslutning till slutpoiten som anges av parametern remoteEP . Om du använder ett anslutningslöst protokoll BeginConnect upprättar du en standardvärd för fjärranslutningen.

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

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

Om du använder ett anslutningslöst protokoll, till exempel UDP, behöver du inte anropa BeginConnect innan du skickar och tar emot data. Du kan använda BeginSendTo och BeginReceiveFrom för att kommunicera med en fjärrvärd. Om du anropar BeginConnectignoreras alla datagram som kommer från en annan adress än den angivna standardinställningen. Om du vill ställa in standardvärden på en sändningsadress måste du först anropa SetSocketOption och ställa in Broadcast till true. Om du inte kan, BeginConnect kommer att kasta en SocketException.

Om du använder ett anslutningsorienterat protokoll och inte anropar Bind innan du anropar BeginConnecttilldelar den underliggande tjänstleverantören den lämpligaste lokala nätverksadressen och portnumret. Om du använder ett anslutningslöst protokoll tilldelar tjänstleverantören inte någon lokal nätverksadress och portnummer förrän du anropar BeginSend metoden eller ReceiveFrom . Om du vill ändra standardvärden för fjärranslutning anropar BeginConnect du metoden igen med önskad slutpunkt.

Om du vill avbryta ett väntande anrop till BeginConnect metoden stänger du Socket. Close När metoden anropas medan en asynkron åtgärd pågår anropas återanropet BeginConnect till metoden. Ett efterföljande anrop till metoden EndConnect 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

Om den här socketen tidigare har kopplats från måste den anropas på en tråd som inte avslutas förrän åtgärden har slutförts BeginConnect . Det här är en begränsning för den underliggande providern.

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

BeginConnect(IPAddress[], 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 begäran om en fjärrvärdanslutning. Värden anges av en IPAddress matris och ett portnummer.

public:
 IAsyncResult ^ BeginConnect(cli::array <System::Net::IPAddress ^> ^ addresses, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect(System.Net.IPAddress[] addresses, int port, AsyncCallback? requestCallback, object? state);

public IAsyncResult BeginConnect(System.Net.IPAddress[] addresses, int port, AsyncCallback requestCallback, object state);

member this.BeginConnect : System.Net.IPAddress[] * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

addresses: IPAddress[]

Minst en IPAddress, som anger fjärrvärden.

port: Int32

Portnumret för fjärrvärden.

requestCallback: AsyncCallback

Ett AsyncCallback ombud som refererar till metoden för att anropa när anslutningsåtgärden är klar.

state: Object

Ett användardefinierat objekt som innehåller information om anslutningsåtgärden. Det här objektet skickas till ombudet requestCallback när åtgärden är klar.

Returer

IAsyncResult

En IAsyncResult som refererar till de asynkrona anslutningarna.

Undantag

ArgumentNullException

addresses är null.

SocketException

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

ObjectDisposedException

Har Socket stängts.

NotSupportedException

Den här metoden är giltig för socketar som använder InterNetwork eller InterNetworkV6.

ArgumentOutOfRangeException

Portnumret är inte giltigt.

ArgumentException

Längden addresses på är noll.

InvalidOperationException

Socket Har placerats i ett lyssningstillstånd genom att anropa Listen(Int32), eller så pågår redan en asynkron åtgärd.

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

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

BeginConnect(String, 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 begäran om en fjärrvärdanslutning. Värden anges med ett värdnamn och ett portnummer.

public:
 IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect(string host, int port, AsyncCallback? requestCallback, object? state);

public IAsyncResult BeginConnect(string host, int port, AsyncCallback requestCallback, object state);

member this.BeginConnect : string * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parametrar

host: String

Namnet på fjärrvärden.

port: Int32

Portnumret för fjärrvärden.

requestCallback: AsyncCallback

Ett AsyncCallback ombud som refererar till metoden för att anropa när anslutningsåtgärden är klar.

state: Object

Ett användardefinierat objekt som innehåller information om anslutningsåtgärden. Det här objektet skickas till ombudet requestCallback när åtgärden är klar.

Returer

IAsyncResult

En IAsyncResult som refererar till den asynkrona anslutningen.

Undantag

ArgumentNullException

host är null.

ObjectDisposedException

Har Socket stängts.

NotSupportedException

Den här metoden är giltig för socketar i InterNetwork familjerna eller InterNetworkV6 .

ArgumentOutOfRangeException

Portnumret är inte giltigt.

InvalidOperationException

Socket Har placerats i ett lyssningstillstånd genom att anropa Listen(Int32), eller så pågår redan en asynkron åtgärd.

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

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?