TcpClient.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.
Verbindet den Client mit einem Remote-TCP-Host mithilfe des angegebenen Hostnamens und der Portnummer als asynchronen Vorgang.
Überlädt
| Name | Beschreibung |
|---|---|
| ConnectAsync(String, Int32, CancellationToken) |
Verbindet den Client mit dem angegebenen TCP-Port auf dem angegebenen Host als asynchronen Vorgang. |
| ConnectAsync(IPAddress[], Int32, CancellationToken) |
Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adressen und der Portnummer als asynchronen Vorgang. |
| ConnectAsync(IPAddress, Int32, CancellationToken) |
Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adresse und portnummer als asynchronen Vorgang. |
| ConnectAsync(String, Int32) |
Verbindet den Client mit dem angegebenen TCP-Port auf dem angegebenen Host als asynchronen Vorgang. |
| ConnectAsync(IPEndPoint, CancellationToken) |
Verbindet den Client mit einem Remote-TCP-Host, der den angegebenen Endpunkt als asynchronen Vorgang verwendet. |
| ConnectAsync(IPAddress[], Int32) |
Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adressen und der Portnummer als asynchronen Vorgang. |
| ConnectAsync(IPAddress, Int32) |
Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adresse und portnummer als asynchronen Vorgang. |
| ConnectAsync(IPEndPoint) |
Verbindet den Client mit einem Remote-TCP-Host, der den angegebenen Endpunkt als asynchronen Vorgang verwendet. |
ConnectAsync(String, Int32, CancellationToken)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
Verbindet den Client mit dem angegebenen TCP-Port auf dem angegebenen Host als asynchronen Vorgang.
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 DNS-Name des Remotehosts.
- port
- Int32
Die Portnummer des Remotehosts.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das verwendet werden kann, um den asynchronen Vorgang zu signalisieren, sollte abgebrochen werden.
Gibt zurück
Eine Aufgabe, die den asynchronen Verbindungsvorgang darstellt.
Ausnahmen
Der host Parameter ist null.
Fehler beim Zugriff auf den Socket.
TcpClient ist geschlossen.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Dieser Vorgang wird nicht blockiert. Die zurückgegebene Aufgabe wird abgeschlossen, nachdem die TCP-Verbindung hergestellt wurde. Diese Methode blockiert den aufrufenden Thread nicht, während die Verbindungsanforderung ausgeführt wird.
Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit dem angegebenen Hostnamen und der angegebenen Portnummer als asynchronen Vorgang herzustellen. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.
Wenn IPv6 aktiviert ist und die Methode aufgerufen wird, um eine Verbindung mit einem Host herzustellen, der ConnectAsync(String, Int32) sowohl zu IPv6- als auch zu IPv4-Adressen aufgelöst wird, wird die Verbindung mit der IPv6-Adresse zuerst vor der IPv4-Adresse versucht. Dies kann dazu führen, dass die Zeit zum Herstellen der Verbindung verzögert wird, wenn der Host nicht auf die IPv6-Adresse lauscht.
Note
Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.
Note
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Connect(String, Int32).
Weitere Informationen
Gilt für:
ConnectAsync(IPAddress[], Int32, CancellationToken)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adressen und der Portnummer als asynchronen Vorgang.
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[]
Das Array der IP-Adresse des Remotehosts.
- port
- Int32
Die Portnummer des Remotehosts.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das verwendet werden kann, um den asynchronen Vorgang zu signalisieren, sollte abgebrochen werden.
Gibt zurück
Eine Aufgabe, die den asynchronen Verbindungsvorgang darstellt.
Ausnahmen
Der addresses Parameter ist null.
Die Portnummer ist ungültig.
Beim Versuch, auf den Socket zuzugreifen, ist ein Fehler aufgetreten.
Das Socket wurde geschlossen.
Ein aufrufer höher im Aufrufstapel verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Diese Methode ist für Sockets gültig, die das InterNetwork Flag oder die InterNetworkV6 Kennzeichnung verwenden.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Dieser Vorgang wird nicht blockiert. Die zurückgegebene Aufgabe wird abgeschlossen, nachdem die TCP-Verbindung hergestellt wurde. Diese Methode blockiert den aufrufenden Thread nicht, während die Verbindungsanforderung ausgeführt wird.
Diese Methode wird in der Regel unmittelbar nach einem Aufruf der BeginGetHostAddresses Methode verwendet, wodurch mehrere IP-Adressen für einen einzelnen Host zurückgegeben werden können. Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit dem Host herzustellen, der durch das Array von IP-Adressen und die Portnummer als asynchroner Vorgang angegeben wird. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.
Note
Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.
Note
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.
Note
Wenn Beim Verwenden der IPv6-Adresse notSupportedException mit Einer Nachricht This protocol version is not supported angezeigt wird, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Connect(IPAddress[], Int32).
Weitere Informationen
Gilt für:
ConnectAsync(IPAddress, Int32, CancellationToken)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adresse und portnummer als asynchronen Vorgang.
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 IP-Adresse des Remotehosts.
- port
- Int32
Die Portnummer des Remotehosts.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das verwendet werden kann, um den asynchronen Vorgang zu signalisieren, sollte abgebrochen werden.
Gibt zurück
Eine Aufgabe, die den asynchronen Verbindungsvorgang darstellt.
Ausnahmen
Der address Parameter ist null.
Fehler beim Zugriff auf den Socket.
TcpClient ist geschlossen.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Dieser Vorgang wird nicht blockiert. Die zurückgegebene Aufgabe wird abgeschlossen, nachdem die TCP-Verbindung hergestellt wurde. Diese Methode blockiert den aufrufenden Thread nicht, während die Verbindungsanforderung ausgeführt wird.
Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit der angegebenen IP-Adresse und Portnummer als asynchronen Vorgang herzustellen. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.
Note
Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.
Note
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.
Note
Wenn Beim Verwenden der IPv6-Adresse notSupportedException mit Einer Nachricht This protocol version is not supported angezeigt wird, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Connect(IPAddress, Int32).
Weitere Informationen
Gilt für:
ConnectAsync(String, Int32)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
Verbindet den Client mit dem angegebenen TCP-Port auf dem angegebenen Host als asynchronen Vorgang.
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 DNS-Name des Remotehosts, mit dem Sie eine Verbindung herstellen möchten.
- port
- Int32
Die Portnummer des Remotehosts, mit dem Sie eine Verbindung herstellen möchten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Der host Parameter ist null.
Fehler beim Zugriff auf den Socket.
TcpClient ist geschlossen.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Returns-Objekt Task wird abgeschlossen, nachdem die TCP-Verbindung hergestellt wurde. Diese Methode blockiert den aufrufenden Thread nicht, während die Verbindungsanforderung ausgeführt wird.
Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit dem angegebenen Hostnamen und der angegebenen Portnummer als asynchronen Vorgang herzustellen. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.
Wenn IPv6 aktiviert ist und die Methode aufgerufen wird, um eine Verbindung mit einem Host herzustellen, der ConnectAsync(String, Int32) sowohl zu IPv6- als auch zu IPv4-Adressen aufgelöst wird, wird die Verbindung mit der IPv6-Adresse zuerst vor der IPv4-Adresse versucht. Dies kann dazu führen, dass die Zeit zum Herstellen der Verbindung verzögert wird, wenn der Host nicht auf die IPv6-Adresse lauscht.
Note
Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.
Note
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Connect(String, Int32).
Weitere Informationen
Gilt für:
ConnectAsync(IPEndPoint, CancellationToken)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
Verbindet den Client mit einem Remote-TCP-Host, der den angegebenen Endpunkt als asynchronen Vorgang verwendet.
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPEndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync(System.Net.IPEndPoint remoteEP, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTaskParameter
- remoteEP
- IPEndPoint
Die IPEndPoint Verbindung, mit der Sie eine Verbindung herstellen möchten.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das zum Verteilen der Benachrichtigung verwendet wird, dass dieser Vorgang abgebrochen werden soll.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Returns-Objekt Task wird abgeschlossen, nachdem die TCP-Verbindung hergestellt wurde. Diese Methode blockiert den aufrufenden Thread nicht, während die Verbindungsanforderung ausgeführt wird.
Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit der angegebenen Methode IPEndPointherzustellen. Vor dem Aufrufen Connectmüssen Sie eine Instanz der IPEndPoint Klasse mit einer IP-Adresse und einer Portnummer erstellen. Verwenden Sie dies IPEndPoint als remoteEP Parameter. Die Connect Methode wird blockiert, bis sie eine Verbindung herstellt oder fehlschlägt. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.
Note
Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.
Note
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.
Note
Wenn Beim Verwenden der IPv6-Adresse notSupportedException mit Einer Nachricht This protocol version is not supported angezeigt wird, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Connect(IPEndPoint).
Gilt für:
ConnectAsync(IPAddress[], Int32)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adressen und der Portnummer als asynchronen Vorgang.
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[]
Das IPAddress Array des Hosts, mit dem Sie eine Verbindung herstellen möchten.
- port
- Int32
Die Portnummer, mit der Sie eine Verbindung herstellen möchten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Der addresses Parameter ist null.
Die Portnummer ist ungültig.
Beim Versuch, auf den Socket zuzugreifen, ist ein Fehler aufgetreten.
Das Socket wurde geschlossen.
Ein aufrufer höher im Aufrufstapel verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Diese Methode ist für Sockets gültig, die das InterNetwork Flag oder die InterNetworkV6 Kennzeichnung verwenden.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Returns-Objekt Task wird abgeschlossen, nachdem die TCP-Verbindung hergestellt wurde. Diese Methode blockiert den aufrufenden Thread nicht, während die Verbindungsanforderung ausgeführt wird.
Diese Methode wird in der Regel unmittelbar nach einem Aufruf der BeginGetHostAddresses Methode verwendet, wodurch mehrere IP-Adressen für einen einzelnen Host zurückgegeben werden können. Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit dem Host herzustellen, der durch das Array von IPAddress Elementen und die Portnummer als asynchroner Vorgang angegeben wird. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.
Note
Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.
Note
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.
Note
Wenn Beim Verwenden der IPv6-Adresse notSupportedException mit Einer Nachricht This protocol version is not supported angezeigt wird, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Connect(IPAddress[], Int32).
Weitere Informationen
Gilt für:
ConnectAsync(IPAddress, Int32)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adresse und portnummer als asynchronen Vorgang.
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
- port
- Int32
Die Portnummer, mit der Sie eine Verbindung herstellen möchten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Der address Parameter ist null.
Fehler beim Zugriff auf den Socket.
TcpClient ist geschlossen.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Returns-Objekt Task wird abgeschlossen, nachdem die TCP-Verbindung hergestellt wurde. Diese Methode blockiert den aufrufenden Thread nicht, während die Verbindungsanforderung ausgeführt wird.
Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit der angegebenen IPAddress Und Portnummer als asynchronen Vorgang herzustellen. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.
Note
Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.
Note
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.
Note
Wenn Beim Verwenden der IPv6-Adresse notSupportedException mit Einer Nachricht This protocol version is not supported angezeigt wird, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Connect(IPAddress, Int32).
Weitere Informationen
Gilt für:
ConnectAsync(IPEndPoint)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
Verbindet den Client mit einem Remote-TCP-Host, der den angegebenen Endpunkt als asynchronen Vorgang verwendet.
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPEndPoint ^ remoteEP);public System.Threading.Tasks.Task ConnectAsync(System.Net.IPEndPoint remoteEP);member this.ConnectAsync : System.Net.IPEndPoint -> System.Threading.Tasks.TaskPublic Function ConnectAsync (remoteEP As IPEndPoint) As TaskParameter
- remoteEP
- IPEndPoint
Die IPEndPoint Verbindung, mit der Sie eine Verbindung herstellen möchten.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task Objekt wird abgeschlossen, nachdem die TCP-Verbindung hergestellt wurde. Diese Methode blockiert den aufrufenden Thread nicht, während die Verbindungsanforderung ausgeführt wird.
Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit der angegebenen Methode IPEndPointherzustellen. Vor dem Aufrufen Connectmüssen Sie eine Instanz der IPEndPoint Klasse mit einer IP-Adresse und einer Portnummer erstellen. Verwenden Sie dies IPEndPoint als remoteEP Parameter. Die Connect Methode wird blockiert, bis sie eine Verbindung herstellt oder fehlschlägt. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.
Note
Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code abgerufen haben, finden Sie in der Dokumentation zur Windows Sockets Version 2 API-Fehlercode eine detaillierte Beschreibung des Fehlers.
Note
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.
Note
Wenn Sie beim Verwenden der IPv6-Adresse eine NotSupportedException Meldung mit der Meldung "Diese Protokollversion wird nicht unterstützt" erhalten, stellen Sie sicher, dass Sie IPv6 im Konstruktor durch Übergeben InterNetworkV6aktiviert haben.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Connect(IPEndPoint).
