TcpClient.Connect Metod

Definition

Ansluter klienten till en fjärransluten TCP-värd med det angivna värdnamnet och portnumret.

Överlagringar

Name Description
Connect(IPEndPoint)

Ansluter klienten till en fjärransluten TCP-värd med den angivna fjärrnätverksslutpunkten.

Connect(IPAddress, Int32)

Ansluter klienten till en fjärransluten TCP-värd med den angivna IP-adressen och portnumret.

Connect(IPAddress[], Int32)

Ansluter klienten till en fjärransluten TCP-värd med angivna IP-adresser och portnummer.

Connect(String, Int32)

Ansluter klienten till den angivna porten på den angivna värden.

Connect(IPEndPoint)

Ansluter klienten till en fjärransluten TCP-värd med den angivna fjärrnätverksslutpunkten.

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)

Parametrar

remoteEP
IPEndPoint

Den IPEndPoint som du tänker ansluta till.

Undantag

Parametern remoteEP är null.

Ett fel uppstod vid åtkomst till socketen.

Exempel

I följande kodexempel används en IPEndPoint för att ansluta till en fjärrvärd.

//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)

Kommentarer

Anropa den här metoden för att upprätta en synkron fjärrvärdanslutning till den angivna IPEndPoint. Innan du anropar Connectmåste du skapa en instans av klassen med hjälp av IPEndPoint en IP-adress och ett portnummer. Använd detta IPEndPoint som remoteEP parameter. Metoden Connect blockeras tills den antingen ansluter eller misslyckas. När du har anslutit med fjärrvärden använder du GetStream metoden för att hämta den underliggande NetworkStream. Använd detta NetworkStream för att skicka och ta emot data.

Note

Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

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 i .NET Framework.

Note

Om du får NotSupportedException med meddelande This protocol version is not supported när du använder IPv6-adressen kontrollerar du att du har aktiverat IPv6 i konstruktorn genom att skicka InterNetworkV6.

Se även

Gäller för

Connect(IPAddress, Int32)

Ansluter klienten till en fjärransluten TCP-värd med den angivna IP-adressen och portnumret.

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)

Parametrar

address
IPAddress

Den IPAddress värd som du tänker ansluta till.

port
Int32

Det portnummer som du tänker ansluta till.

Undantag

Parametern address är null.

port är inte mellan MinPort och MaxPort.

Ett fel uppstod vid åtkomst till socketen.

Exempel

I följande kodexempel används en IP-adress och ett portnummer för att ansluta till en fjärrvärd.

//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)

Kommentarer

Anropa den här metoden för att upprätta en synkron fjärrvärdanslutning till angivet IPAddress och portnummer. Metoden Connect blockeras tills den antingen ansluter eller misslyckas. När du har anslutit med fjärrvärden använder du GetStream metoden för att hämta den underliggande NetworkStream. Använd detta NetworkStream för att skicka och ta emot data.

Note

Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

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 i .NET Framework.

Note

Om du får NotSupportedException med meddelande This protocol version is not supported när du använder IPv6-adressen kontrollerar du att du har aktiverat IPv6 i konstruktorn genom att skicka InterNetworkV6.

Se även

Gäller för

Connect(IPAddress[], Int32)

Ansluter klienten till en fjärransluten TCP-värd med angivna IP-adresser och portnummer.

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)

Parametrar

ipAddresses
IPAddress[]

Matrisen IPAddress för den värd som du tänker ansluta till.

port
Int32

Det portnummer som du tänker ansluta till.

Undantag

Parametern ipAddresses är null.

Portnumret är inte giltigt.

Ett fel uppstod vid försök att komma åt socketen.

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

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

Exempel

I följande kodexempel används en IP-adress och ett portnummer för att ansluta till en fjärrvärd.

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");
}

Kommentarer

Den här metoden används vanligtvis omedelbart efter ett anrop till BeginGetHostAddresses metoden, som kan returnera flera IP-adresser för en enda värd. Connect Anropa metoden för att upprätta en synkron fjärrvärdanslutning till värden som anges av matrisen med IPAddress element och portnumret. Metoden Connect blockeras tills den antingen ansluter eller misslyckas. När du har anslutit med fjärrvärden använder du GetStream metoden för att hämta den underliggande NetworkStream. Använd detta NetworkStream för att skicka och ta emot data.

Note

Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

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 i .NET Framework.

Note

Om du får NotSupportedException med meddelande This protocol version is not supported när du använder IPv6-adressen kontrollerar du att du har aktiverat IPv6 i konstruktorn genom att skicka InterNetworkV6.

Se även

Gäller för

Connect(String, Int32)

Ansluter klienten till den angivna porten på den angivna värden.

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)

Parametrar

hostname
String

DNS-namnet på fjärrvärden som du tänker ansluta till.

port
Int32

Portnumret för fjärrvärden som du tänker ansluta till.

Undantag

Parametern hostname är null.

Parametern port är inte mellan MinPort och MaxPort.

Ett fel uppstod vid åtkomst till socketen.

Exempel

I följande kodexempel används värdnamnet och portnumret för att ansluta till en fjärrvärd.

//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)

Kommentarer

Anropa den här metoden för att upprätta en synkron fjärrvärdanslutning till det angivna värdnamnet och portnumret. Metoden Connect blockeras tills den antingen ansluter eller misslyckas. När du har anslutit med fjärrvärden använder du GetStream metoden för att hämta den underliggande NetworkStream. Använd detta NetworkStream för att skicka och ta emot data.

Om IPv6 är aktiverat och Connect(String, Int32) metoden anropas för att ansluta till en värd som matchar både IPv6- och IPv4-adresser, görs ett försök att ansluta till IPv6-adressen först före IPv4-adressen. Detta kan medföra att tiden för att upprätta anslutningen fördröjs om värden inte lyssnar på IPv6-adressen.

Note

Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

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 i .NET Framework.

Se även

Gäller för