TcpClient.Connect Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de client verbonden met een externe TCP-host met behulp van de opgegeven hostnaam en poortnummer.
Overloads
| Name | Description |
|---|---|
| Connect(IPEndPoint) |
Hiermee wordt de client verbonden met een externe TCP-host met behulp van het opgegeven externe netwerkeindpunt. |
| Connect(IPAddress, Int32) |
Hiermee wordt de client verbonden met een externe TCP-host met behulp van het opgegeven IP-adres en poortnummer. |
| Connect(IPAddress[], Int32) |
Hiermee wordt de client verbonden met een externe TCP-host met behulp van de opgegeven IP-adressen en het poortnummer. |
| Connect(String, Int32) |
Hiermee wordt de client verbonden met de opgegeven poort op de opgegeven host. |
Connect(IPEndPoint)
Hiermee wordt de client verbonden met een externe TCP-host met behulp van het opgegeven externe netwerkeindpunt.
public:
void Connect(System::Net::IPEndPoint ^ remoteEP);
public void Connect(System.Net.IPEndPoint remoteEP);
member this.Connect : System.Net.IPEndPoint -> unit
Public Sub Connect (remoteEP As IPEndPoint)
Parameters
- remoteEP
- IPEndPoint
De IPEndPoint verbinding waarmee u verbinding wilt maken.
Uitzonderingen
De remoteEP parameter is null.
Er is een fout opgetreden bij het openen van de socket.
De TcpClient is gesloten.
Voorbeelden
In het volgende codevoorbeeld wordt een IPEndPoint code gebruikt om verbinding te maken met een externe host.
//Uses a remote endpoint to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint (ipAddress, 11004);
tcpClient.Connect (ipEndPoint);
'Uses a remote endpoint to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)
tcpClient.Connect(ipEndPoint)
Opmerkingen
Roep deze methode aan om een synchrone externe hostverbinding tot stand te brengen met de opgegeven IPEndPoint. Voordat u aanroept Connect, moet u een exemplaar van de IPEndPoint klasse maken met behulp van een IP-adres en een poortnummer. Gebruik deze IPEndPoint als parameter remoteEP . De Connect methode wordt geblokkeerd totdat deze verbinding maakt of mislukt. Nadat u verbinding hebt gemaakt met de externe host, gebruikt u de GetStream methode om de onderliggende NetworkStreamgegevens op te halen. Gebruik deze NetworkStream optie om gegevens te verzenden en te ontvangen.
Note
Als u een SocketException, gebruikt SocketException.ErrorCode om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.
Note
Als u NotSupportedException ontvangt met een bericht This protocol version is not supported tijdens het gebruik van het IPv6-adres, controleert u of u IPv6 hebt ingeschakeld in de constructor door deze door te geven InterNetworkV6.
Zie ook
Van toepassing op
Connect(IPAddress, Int32)
Hiermee wordt de client verbonden met een externe TCP-host met behulp van het opgegeven IP-adres en poortnummer.
public:
void Connect(System::Net::IPAddress ^ address, int port);
public void Connect(System.Net.IPAddress address, int port);
member this.Connect : System.Net.IPAddress * int -> unit
Public Sub Connect (address As IPAddress, port As Integer)
Parameters
- port
- Int32
Het poortnummer waarmee u verbinding wilt maken.
Uitzonderingen
De address parameter is null.
Er is een fout opgetreden bij het openen van de socket.
TcpClient is gesloten.
Voorbeelden
In het volgende codevoorbeeld wordt een IP-adres en poortnummer gebruikt om verbinding te maken met een externe host.
//Uses the IP address and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];
tcpClient.Connect (ipAddress, 11003);
'Uses the IP address and port number to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
tcpClient.Connect(ipAddress, 11003)
Opmerkingen
Roep deze methode aan om een synchrone externe hostverbinding tot stand te brengen met het opgegeven IPAddress en poortnummer. De Connect methode wordt geblokkeerd totdat deze verbinding maakt of mislukt. Nadat u verbinding hebt gemaakt met de externe host, gebruikt u de GetStream methode om de onderliggende NetworkStreamgegevens op te halen. Gebruik deze NetworkStream optie om gegevens te verzenden en te ontvangen.
Note
Als u een SocketException, gebruikt SocketException.ErrorCode om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.
Note
Als u NotSupportedException ontvangt met een bericht This protocol version is not supported tijdens het gebruik van het IPv6-adres, controleert u of u IPv6 hebt ingeschakeld in de constructor door deze door te geven InterNetworkV6.
Zie ook
Van toepassing op
Connect(IPAddress[], Int32)
Hiermee wordt de client verbonden met een externe TCP-host met behulp van de opgegeven IP-adressen en het poortnummer.
public:
void Connect(cli::array <System::Net::IPAddress ^> ^ ipAddresses, int port);
public void Connect(System.Net.IPAddress[] ipAddresses, int port);
member this.Connect : System.Net.IPAddress[] * int -> unit
Public Sub Connect (ipAddresses As IPAddress(), port As Integer)
Parameters
- port
- Int32
Het poortnummer waarmee u verbinding wilt maken.
Uitzonderingen
De ipAddresses parameter is null.
Het poortnummer is ongeldig.
Er is een fout opgetreden bij het openen van de socket.
De Socket is gesloten.
Een aanroeper hoger in de aanroepstack heeft geen machtiging voor de aangevraagde bewerking.
Deze methode is geldig voor sockets die gebruikmaken van de InterNetwork vlag of de InterNetworkV6 vlag.
Voorbeelden
In het volgende codevoorbeeld wordt een IP-adres en poortnummer gebruikt om verbinding te maken met een externe host.
static void DoConnect(string host, int port)
{
// Connect to the specified host.
TcpClient t = new TcpClient(AddressFamily.InterNetwork);
IPAddress[] IPAddresses = Dns.GetHostAddresses(host);
Console.WriteLine("Establishing connection to {0}", host);
t.Connect(IPAddresses, port);
Console.WriteLine("Connection established");
}
Opmerkingen
Deze methode wordt doorgaans onmiddellijk na een aanroep naar de BeginGetHostAddresses methode gebruikt, waardoor meerdere IP-adressen voor één host kunnen worden geretourneerd. Roep de Connect methode aan om een synchrone externe hostverbinding tot stand te brengen met de host die is opgegeven door de matrix met IPAddress elementen en het poortnummer. De Connect methode wordt geblokkeerd totdat deze verbinding maakt of mislukt. Nadat u verbinding hebt gemaakt met de externe host, gebruikt u de GetStream methode om de onderliggende NetworkStreamgegevens op te halen. Gebruik deze NetworkStream optie om gegevens te verzenden en te ontvangen.
Note
Als u een SocketException, gebruikt SocketException.ErrorCode om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.
Note
Als u NotSupportedException ontvangt met een bericht This protocol version is not supported tijdens het gebruik van het IPv6-adres, controleert u of u IPv6 hebt ingeschakeld in de constructor door deze door te geven InterNetworkV6.
Zie ook
Van toepassing op
Connect(String, Int32)
Hiermee wordt de client verbonden met de opgegeven poort op de opgegeven host.
public:
void Connect(System::String ^ hostname, int port);
public void Connect(string hostname, int port);
member this.Connect : string * int -> unit
Public Sub Connect (hostname As String, port As Integer)
Parameters
- hostname
- String
De DNS-naam van de externe host waarmee u verbinding wilt maken.
- port
- Int32
Het poortnummer van de externe host waarmee u verbinding wilt maken.
Uitzonderingen
De hostname parameter is null.
Er is een fout opgetreden bij het openen van de socket.
TcpClient is gesloten.
Voorbeelden
In het volgende codevoorbeeld worden de hostnaam en het poortnummer gebruikt om verbinding te maken met een externe host.
//Uses a host name and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
tcpClient.Connect ("www.contoso.com", 11002);
'Uses a host name and port number to establish a socket connection.
Dim tcpClient As New TcpClient()
tcpClient.Connect("www.contoso.com", 11002)
Opmerkingen
Roep deze methode aan om een synchrone externe hostverbinding tot stand te brengen met de opgegeven hostnaam en poortnummer. De Connect methode wordt geblokkeerd totdat deze verbinding maakt of mislukt. Nadat u verbinding hebt gemaakt met de externe host, gebruikt u de GetStream methode om de onderliggende NetworkStreamgegevens op te halen. Gebruik deze NetworkStream optie om gegevens te verzenden en te ontvangen.
Als IPv6 is ingeschakeld en de Connect(String, Int32) methode wordt aangeroepen om verbinding te maken met een host die wordt omgezet naar zowel IPv6- als IPv4-adressen, wordt de verbinding met het IPv6-adres eerst geprobeerd vóór het IPv4-adres. Dit kan het gevolg zijn van het vertragen van de tijd om de verbinding tot stand te brengen als de host niet luistert op het IPv6-adres.
Note
Als u een SocketException, gebruikt SocketException.ErrorCode om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.