Socket.ConnectAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Beginnt eine asynchrone Anforderung einer Verbindung mit einem Remotehost.
Überlädt
| ConnectAsync(SocketType, ProtocolType, SocketAsyncEventArgs) |
Beginnt eine asynchrone Anforderung einer Verbindung mit einem Remotehost. |
| ConnectAsync(IPAddress[], Int32, CancellationToken) |
Stellt eine Verbindung mit einem Remotehost her. |
| ConnectAsync(String, Int32, CancellationToken) |
Stellt eine Verbindung mit einem Remotehost her. |
| ConnectAsync(IPAddress, Int32, CancellationToken) |
Stellt eine Verbindung mit einem Remotehost her. |
| ConnectAsync(String, Int32) |
Stellt eine Verbindung mit einem Remotehost her. |
| ConnectAsync(IPAddress[], Int32) |
Stellt eine Verbindung mit einem Remotehost her. |
| ConnectAsync(IPAddress, Int32) |
Stellt eine Verbindung mit einem Remotehost her. |
| ConnectAsync(EndPoint, CancellationToken) |
Stellt eine Verbindung mit einem Remotehost her. |
| ConnectAsync(SocketAsyncEventArgs) |
Beginnt eine asynchrone Anforderung einer Verbindung mit einem Remotehost. |
| ConnectAsync(EndPoint) |
Stellt eine Verbindung mit einem Remotehost her. |
ConnectAsync(SocketType, ProtocolType, SocketAsyncEventArgs)
- Quelle:
- Socket.cs
- Quelle:
- Socket.cs
- Quelle:
- Socket.cs
Beginnt eine asynchrone Anforderung einer Verbindung mit einem Remotehost.
public:
static bool ConnectAsync(System::Net::Sockets::SocketType socketType, System::Net::Sockets::ProtocolType protocolType, System::Net::Sockets::SocketAsyncEventArgs ^ e);public static bool ConnectAsync (System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType, System.Net.Sockets.SocketAsyncEventArgs e);static member ConnectAsync : System.Net.Sockets.SocketType * System.Net.Sockets.ProtocolType * System.Net.Sockets.SocketAsyncEventArgs -> boolPublic Shared Function ConnectAsync (socketType As SocketType, protocolType As ProtocolType, e As SocketAsyncEventArgs) As BooleanParameter
- socketType
- SocketType
Einer der SocketType-Werte.
- protocolType
- ProtocolType
Einer der ProtocolType-Werte.
Das SocketAsyncEventArgs-Objekt, das für diesen asynchronen Socketvorgang verwendet werden soll.
Gibt zurück
true, wenn der E/A-Vorgang aussteht. Das Completed-Ereignis für den e-Parameter wird nach dem Abschluss des Vorgangs ausgelöst.
false, wenn der E/A-Vorgang synchron abgeschlossen wurde. In diesem Fall wird das Completed-Ereignis für den e-Parameter nicht ausgelöst, und das als Parameter übergebene e-Objekt kann direkt nach der Rückgabe des Methodenaufrufs untersucht werden, um die Ergebnisse des Vorgangs abzurufen.
Ausnahmen
Ein Argument ist ungültig. Diese Ausnahme tritt auf, wenn mehrere Puffer angegeben werden und die BufferList-Eigenschaft nicht NULL ist.
Der e-Parameter kann nicht NULL und der RemoteEndPoint kann nicht NULL sein.
Der Socket führt eine Überwachung durch, oder ein Socketvorgang wird bereits mit dem im e-Parameter angegebenen SocketAsyncEventArgs-Objekt ausgeführt.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der lokale Endpunkt und der RemoteEndPoint sind nicht die gleiche Adressfamilie.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Hinweise
Wenn Sie ein verbindungsorientiertes Protokoll verwenden, startet die M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs)-Methode eine asynchrone Anforderung für eine Verbindung mit dem Remotehost. Wenn Sie ein verbindungsloses Protokoll verwenden, wird ein Standard-Remotehost eingerichtet, ConnectAsync der durch die socketType Parameter und protocolType angegeben wird.
Um über den Abschluss benachrichtigt zu werden, müssen Sie eine Rückrufmethode erstellen, die den EventHandler<SocketAsyncEventArgs-Delegaten> implementiert, und den Rückruf an das SocketAsyncEventArgs.Completed Ereignis anfügen.
Der Aufrufer muss die SocketAsyncEventArgs.RemoteEndPoint -Eigenschaft auf den des Remotehosts festlegen, mit dem IPEndPoint eine Verbindung hergestellt werden soll.
Der Aufrufer kann die SocketAsyncEventArgs.UserToken -Eigenschaft auf ein beliebiges Benutzerzustandsobjekt festlegen, bevor die ConnectAsync -Methode aufgerufen wird, sodass die Informationen in der Rückrufmethode abgerufen werden können. Wenn der Rückruf mehr Informationen als ein einzelnes Objekt benötigt, kann eine kleine Klasse erstellt werden, die die anderen erforderlichen Zustandsinformationen als Member enthält.
Wenn Sie ein verbindungsloses Protokoll wie UDP verwenden, müssen Sie vor dem Senden und Empfangen von Daten nicht aufrufen ConnectAsync . Sie können und ReceiveFromAsync verwendenSendToAsync, um mit einem Remotehost zu kommunizieren. Wenn Sie aufrufen ConnectAsync, werden alle Datagramme verworfen, die von einer anderen Adresse als der angegebenen Standardadresse empfangen werden. Wenn Sie den Standard-Remotehost ändern möchten, rufen Sie die ConnectAsync -Methode erneut mit dem gewünschten Endpunkt auf.
Wenn Sie den Standard-Remotehost auf eine Broadcastadresse festlegen möchten, müssen Sie zuerst aufrufen SetSocketOption und Broadcast auf truefestlegen. Wenn dies nicht der Fall ist, löst die ConnectAsync -Methode einen aus SocketException.
Die folgenden Eigenschaften und Ereignisse für das System.Net.Sockets.SocketAsyncEventArgs Objekt sind erforderlich:
Optional kann ein Puffer bereitgestellt werden, der atomar an den Socket gesendet wird, nachdem die ConnectAsync Methode erfolgreich war. In diesem Fall muss die SocketAsyncEventArgs.Buffer -Eigenschaft auf den Puffer festgelegt werden, der die zu sendenden Daten enthält, und die SocketAsyncEventArgs.Count -Eigenschaft muss auf die Anzahl der Daten festgelegt werden, die vom Puffer gesendet werden sollen. Sobald eine Verbindung hergestellt wurde, wird dieser Datenpuffer gesendet.
Wenn Sie ein verbindungsorientiertes Protokoll verwenden und vor dem Aufrufen ConnectAsyncnicht aufrufenBind, weist der zugrunde liegende Dienstanbieter die am besten geeignete lokale Netzwerkadresse und Portnummer zu.
Wenn Sie ein verbindungsloses Protokoll verwenden, weist der Dienstanbieter erst dann eine IP-Adresse und Portnummer des lokalen Netzwerks zu, wenn Sie die SendAsync Methoden oder ReceiveAsync aufrufen.
Die ConnectAsync -Methode löst aus NotSupportedException , wenn die Adressfamilie von Socket und nicht SocketAsyncEventArgs.RemoteEndPoint die gleiche Adressfamilie ist.
Hinweis
Wenn Sie beim Aufrufen dieser Methode eine SocketException erhalten, verwenden Sie die SocketException.ErrorCode -Eigenschaft, um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode eine ausführliche Beschreibung des Fehlers.
Gilt für:
ConnectAsync(IPAddress[], Int32, CancellationToken)
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
Stellt eine Verbindung mit einem Remotehost her.
public:
System::Threading::Tasks::ValueTask ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTaskParameter
- addresses
- IPAddress[]
Eine Liste der IPAddresses für den Remotehost, der zum Herstellen einer Verbindung mit dem Remotehost verwendet wird.
- port
- Int32
Der Port auf dem Remotehost, mit dem eine Verbindung hergestellt werden soll.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das zum Abbrechen des asynchronen Vorgangs verwendet werden kann.
Gibt zurück
Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.
Ausnahmen
Der addresses-Parameter darf nicht NULL sein.
Der addresses Parameter darf kein leeres Array sein.
Die Socket lauscht.
Der Socket ist nicht in der InterNetwork - oder InterNetworkV6 -Familie vorhanden.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(IPAddress[], Int32).
Gilt für:
ConnectAsync(String, Int32, CancellationToken)
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
Stellt eine Verbindung mit einem Remotehost her.
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync (string host, int port, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTaskParameter
- host
- String
Der Hostname des Remotehosts, mit dem eine Verbindung hergestellt werden soll.
- port
- Int32
Der Port auf dem Remotehost, mit dem eine Verbindung hergestellt werden soll.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das zum Abbrechen des asynchronen Vorgangs verwendet werden kann.
Gibt zurück
Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.
Ausnahmen
Der host-Parameter darf nicht NULL sein.
Die Socket lauscht.
Der Socket ist nicht in der InterNetwork - oder InterNetworkV6 -Familie vorhanden.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(String, Int32).
Gilt für:
ConnectAsync(IPAddress, Int32, CancellationToken)
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
Stellt eine Verbindung mit einem Remotehost her.
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTaskParameter
- address
- IPAddress
Die IPAddress des Remotehosts, mit dem eine Verbindung hergestellt werden soll.
- port
- Int32
Der Port auf dem Remotehost, mit dem eine Verbindung hergestellt werden soll.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das zum Abbrechen des asynchronen Vorgangs verwendet werden kann.
Gibt zurück
Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.
Ausnahmen
Der address-Parameter darf nicht NULL sein.
Die Socket lauscht.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(IPAddress, Int32).
Gilt für:
ConnectAsync(String, Int32)
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
Stellt eine Verbindung mit einem Remotehost her.
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);public System.Threading.Tasks.Task ConnectAsync (string host, int port);member this.ConnectAsync : string * int -> System.Threading.Tasks.TaskPublic Function ConnectAsync (host As String, port As Integer) As TaskParameter
- host
- String
Der Hostname des Remotehosts, mit dem eine Verbindung hergestellt werden soll.
- port
- Int32
Der Port auf dem Remotehost, mit dem eine Verbindung hergestellt werden soll.
Gibt zurück
Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.
Ausnahmen
Der host-Parameter darf nicht NULL sein.
Die Socket lauscht.
Der Socket ist nicht in der InterNetwork - oder InterNetworkV6 -Familie vorhanden.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Hinweise
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(String, Int32).
Gilt für:
ConnectAsync(IPAddress[], Int32)
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
Stellt eine Verbindung mit einem Remotehost her.
public:
System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress[] addresses, int port);member this.ConnectAsync : System.Net.IPAddress[] * int -> System.Threading.Tasks.TaskPublic Function ConnectAsync (addresses As IPAddress(), port As Integer) As TaskParameter
- addresses
- IPAddress[]
Eine Liste der IPAddresses für den Remotehost, der zum Herstellen einer Verbindung mit dem Remotehost verwendet wird.
- port
- Int32
Der Port auf dem Remotehost, mit dem eine Verbindung hergestellt werden soll.
Gibt zurück
Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.
Ausnahmen
Der addresses-Parameter darf nicht NULL sein.
Der addresses Parameter darf kein leeres Array sein.
Die Socket lauscht.
Der Socket ist nicht in der InterNetwork - oder InterNetworkV6 -Familie vorhanden.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Hinweise
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(IPAddress[], Int32).
Gilt für:
ConnectAsync(IPAddress, Int32)
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
Stellt eine Verbindung mit einem Remotehost her.
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress address, int port);member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.TaskPublic Function ConnectAsync (address As IPAddress, port As Integer) As TaskParameter
- address
- IPAddress
Die IPAddress des Remotehosts, mit dem eine Verbindung hergestellt werden soll.
- port
- Int32
Der Port auf dem Remotehost, mit dem eine Verbindung hergestellt werden soll.
Gibt zurück
Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.
Ausnahmen
Der address-Parameter darf nicht NULL sein.
Die Socket lauscht.
Der Socket ist nicht in der InterNetwork - oder InterNetworkV6 -Familie vorhanden.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Hinweise
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(IPAddress, Int32).
Gilt für:
ConnectAsync(EndPoint, CancellationToken)
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
Stellt eine Verbindung mit einem Remotehost her.
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::Net::EndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.EndPoint remoteEP, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (remoteEP As EndPoint, cancellationToken As CancellationToken) As ValueTaskParameter
- remoteEP
- EndPoint
Der Endpunkt, mit dem eine Verbindung hergestellt werden soll.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das zum Abbrechen des asynchronen Vorgangs verwendet werden kann.
Gibt zurück
Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.
Ausnahmen
Der remoteEP-Parameter darf nicht NULL sein.
Die Socket lauscht.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der lokale Endpunkt und der remoteEP Parameter sind nicht die gleiche Adressfamilie.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(EndPoint).
Gilt für:
ConnectAsync(SocketAsyncEventArgs)
- Quelle:
- Socket.cs
- Quelle:
- Socket.cs
- Quelle:
- Socket.cs
Beginnt eine asynchrone Anforderung einer Verbindung mit einem Remotehost.
public:
bool ConnectAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);public bool ConnectAsync (System.Net.Sockets.SocketAsyncEventArgs e);member this.ConnectAsync : System.Net.Sockets.SocketAsyncEventArgs -> boolPublic Function ConnectAsync (e As SocketAsyncEventArgs) As BooleanParameter
Das SocketAsyncEventArgs-Objekt, das für diesen asynchronen Socketvorgang verwendet werden soll.
Gibt zurück
true, wenn der E/A-Vorgang aussteht. Das Completed-Ereignis für den e-Parameter wird nach dem Abschluss des Vorgangs ausgelöst.
false, wenn der E/A-Vorgang synchron abgeschlossen wurde. In diesem Fall wird das Completed-Ereignis für den e-Parameter nicht ausgelöst, und das als Parameter übergebene e-Objekt kann direkt nach der Rückgabe des Methodenaufrufs untersucht werden, um die Ergebnisse des Vorgangs abzurufen.
Ausnahmen
Ein Argument ist ungültig. Diese Ausnahme tritt auf, wenn mehrere Puffer angegeben werden und die BufferList-Eigenschaft nicht NULL ist.
Der e-Parameter kann nicht NULL und der RemoteEndPoint kann nicht NULL sein.
Der Socket führt eine Überwachung durch, oder ein Socketvorgang wird bereits mit dem im e-Parameter angegebenen SocketAsyncEventArgs-Objekt ausgeführt.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der lokale Endpunkt und der RemoteEndPoint sind nicht die gleiche Adressfamilie.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Hinweise
Wenn Sie ein verbindungsorientiertes Protokoll verwenden, startet die ConnectAsync Methode eine asynchrone Anforderung für eine Verbindung mit dem Remotehost. Wenn Sie ein verbindungsloses Protokoll verwenden, ConnectAsync wird ein Standard-Remotehost eingerichtet.
Um über den Abschluss benachrichtigt zu werden, müssen Sie eine Rückrufmethode erstellen, die den EventHandler<SocketAsyncEventArgs-Delegaten> implementiert, und den Rückruf an das SocketAsyncEventArgs.Completed Ereignis anfügen.
Der Aufrufer muss die SocketAsyncEventArgs.RemoteEndPoint -Eigenschaft auf den des Remotehosts festlegen, mit dem IPEndPoint eine Verbindung hergestellt werden soll.
Der Aufrufer kann die SocketAsyncEventArgs.UserToken -Eigenschaft auf ein beliebiges Benutzerzustandsobjekt festlegen, bevor die ConnectAsync -Methode aufgerufen wird, sodass die Informationen in der Rückrufmethode abgerufen werden können. Wenn der Rückruf mehr Informationen als ein einzelnes Objekt benötigt, kann eine kleine Klasse erstellt werden, die die anderen erforderlichen Zustandsinformationen als Member enthält.
Wenn Sie ein verbindungsloses Protokoll wie UDP verwenden, müssen Sie vor dem Senden und Empfangen von Daten nicht aufrufen ConnectAsync . Sie können und ReceiveFromAsync verwendenSendToAsync, um mit einem Remotehost zu kommunizieren. Wenn Sie aufrufen ConnectAsync, werden alle Datagramme verworfen, die von einer anderen Adresse als der angegebenen Standardadresse empfangen werden. Wenn Sie den Standard-Remotehost ändern möchten, rufen Sie die ConnectAsync -Methode erneut mit dem gewünschten Endpunkt auf.
Wenn Sie den Standard-Remotehost auf eine Broadcastadresse festlegen möchten, müssen Sie zuerst aufrufen SetSocketOption und Broadcast auf truefestlegen. Wenn dies nicht der Fall ist, löst die ConnectAsync -Methode einen aus SocketException.
Die folgenden Eigenschaften und Ereignisse für das System.Net.Sockets.SocketAsyncEventArgs Objekt sind erforderlich:
Optional kann ein Puffer bereitgestellt werden, der atomar an den Socket gesendet wird, nachdem die ConnectAsync Methode erfolgreich war. In diesem Fall muss die SocketAsyncEventArgs.Buffer -Eigenschaft auf den Puffer festgelegt werden, der die zu sendenden Daten enthält, und die SocketAsyncEventArgs.Count -Eigenschaft muss auf die Anzahl der Daten festgelegt werden, die vom Puffer gesendet werden sollen. Sobald eine Verbindung hergestellt wurde, wird dieser Datenpuffer gesendet.
Wenn Sie ein verbindungsorientiertes Protokoll verwenden und vor dem Aufrufen ConnectAsyncnicht aufrufenBind, weist der zugrunde liegende Dienstanbieter die am besten geeignete lokale Netzwerkadresse und Portnummer zu.
Wenn Sie ein verbindungsloses Protokoll verwenden, weist der Dienstanbieter erst dann eine IP-Adresse und Portnummer des lokalen Netzwerks zu, wenn Sie die SendAsync Methoden oder ReceiveAsync aufrufen.
Die ConnectAsync -Methode löst aus NotSupportedException , wenn die Adressfamilie von Socket und nicht SocketAsyncEventArgs.RemoteEndPoint die gleiche Adressfamilie ist.
Hinweis
Wenn Sie beim Aufrufen dieser Methode eine SocketException erhalten, verwenden Sie die SocketException.ErrorCode -Eigenschaft, um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode eine ausführliche Beschreibung des Fehlers.
Weitere Informationen
Gilt für:
ConnectAsync(EndPoint)
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
- Quelle:
- Socket.Tasks.cs
Stellt eine Verbindung mit einem Remotehost her.
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::Net::EndPoint ^ remoteEP);public System.Threading.Tasks.Task ConnectAsync (System.Net.EndPoint remoteEP);member this.ConnectAsync : System.Net.EndPoint -> System.Threading.Tasks.TaskPublic Function ConnectAsync (remoteEP As EndPoint) As TaskParameter
- remoteEP
- EndPoint
Der Endpunkt, mit dem eine Verbindung hergestellt werden soll.
Gibt zurück
Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.
Ausnahmen
Der remoteEP-Parameter darf nicht NULL sein.
Die Socket lauscht.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der lokale Endpunkt und der remoteEP Parameter sind nicht die gleiche Adressfamilie.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Hinweise
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(EndPoint).
