Share via

TcpClient.Connect Metode

  • Referensi

Definisi

Ruang nama:
System.Net.Sockets
Rakitan:
System.Net.Sockets.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

Menyambungkan klien ke host TCP jarak jauh menggunakan nama host dan nomor port yang ditentukan.

Overload

Connect(IPEndPoint)

Menyambungkan klien ke host TCP jarak jauh menggunakan titik akhir jaringan jarak jauh yang ditentukan.
Connect(IPAddress, Int32)

Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan.
Connect(IPAddress[], Int32)

Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan.
Connect(String, Int32)

Menyambungkan klien ke port yang ditentukan pada host yang ditentukan.

Connect(IPEndPoint)

Sumber:
TCPClient.cs
Sumber:
TCPClient.cs
Sumber:
TCPClient.cs

Menyambungkan klien ke host TCP jarak jauh menggunakan titik akhir jaringan jarak jauh yang ditentukan.

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)

Parameter

remoteEP
IPEndPoint

yang IPEndPoint ingin Anda sambungkan.

Pengecualian

ArgumentNullException

Parameternya remoteEp adalah null.

SocketException

Terjadi kesalahan saat mengakses soket.

ObjectDisposedException

Sudah TcpClient ditutup.

Contoh

Contoh kode berikut menggunakan IPEndPoint untuk terhubung dengan host jarak jauh.

//Uses a remote end point to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
tcpClient->Connect( ipEndPoint );

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

Keterangan

Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke yang ditentukan IPEndPoint. Sebelum memanggil Connect, Anda harus membuat instans IPEndPoint kelas menggunakan alamat IP dan nomor port. Gunakan ini IPEndPoint sebagai remoteEP parameter . Metode Connect ini akan memblokir hingga tersambung atau gagal. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Catatan

Jika Anda menerima NotSupportedException dengan pesan This protocol version is not supported saat menggunakan alamat IPv6, pastikan Anda mengaktifkan IPv6 di konstruktor dengan meneruskan InterNetworkV6.

Lihat juga

Berlaku untuk

Connect(IPAddress, Int32)

Sumber:
TCPClient.cs
Sumber:
TCPClient.cs
Sumber:
TCPClient.cs

Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan.

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)

Parameter

address
IPAddress

Host IPAddress yang ingin Anda sambungkan.

port
Int32

Nomor port yang ingin Anda sambungkan.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

ArgumentOutOfRangeException

port bukan antara MinPort dan MaxPort.

SocketException

Terjadi kesalahan saat mengakses soket.

ObjectDisposedException

TcpClient ditutup.

Contoh

Contoh kode berikut menggunakan Alamat IP dan nomor port untuk terhubung dengan host jarak jauh.

//Uses the IP address and port number to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
tcpClient->Connect( ipAddress, 11003 );

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

Keterangan

Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke nomor port dan yang ditentukan IPAddress . Metode Connect ini akan memblokir hingga tersambung atau gagal. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Catatan

Jika Anda menerima NotSupportedException dengan pesan This protocol version is not supported saat menggunakan alamat IPv6, pastikan Anda mengaktifkan IPv6 di konstruktor dengan meneruskan InterNetworkV6.

Lihat juga

Berlaku untuk

Connect(IPAddress[], Int32)

Sumber:
TCPClient.cs
Sumber:
TCPClient.cs
Sumber:
TCPClient.cs

Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan.

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)

Parameter

ipAddresses
IPAddress[]

Array IPAddress host yang ingin Anda sambungkan.

port
Int32

Nomor port yang ingin Anda sambungkan.

Pengecualian

ArgumentNullException

Parameternya ipAddresses adalah null.

ArgumentOutOfRangeException

Nomor port tidak valid.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

ObjectDisposedException

Sudah Socket ditutup.

SecurityException

Penelepon yang lebih tinggi dalam tumpukan panggilan tidak memiliki izin untuk operasi yang diminta.

NotSupportedException

Metode ini berlaku untuk soket yang menggunakan InterNetwork bendera atau InterNetworkV6 bendera .

Contoh

Contoh kode berikut menggunakan Alamat IP dan nomor port untuk terhubung dengan host jarak jauh.

static void DoConnect( String^ host, int port )
{
   // Connect to the specified host.
   TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
   array<IPAddress^>^IPAddresses = Dns::GetHostAddresses( host );
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->Connect( IPAddresses, port );
   Console::WriteLine( "Connection established" );
}

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

Keterangan

Metode ini biasanya digunakan segera setelah panggilan ke BeginGetHostAddresses metode , yang dapat mengembalikan beberapa alamat IP untuk satu host. Connect Panggil metode untuk membuat koneksi host jarak jauh sinkron ke host yang ditentukan oleh array IPAddress elemen dan nomor port. Metode Connect ini akan memblokir hingga tersambung atau gagal. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Catatan

Jika Anda menerima NotSupportedException dengan pesan This protocol version is not supported saat menggunakan alamat IPv6, pastikan Anda mengaktifkan IPv6 di konstruktor dengan meneruskan InterNetworkV6.

Lihat juga

Berlaku untuk

Connect(String, Int32)

Sumber:
TCPClient.cs
Sumber:
TCPClient.cs
Sumber:
TCPClient.cs

Menyambungkan klien ke port yang ditentukan pada host yang ditentukan.

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)

Parameter

hostname
String

Nama DNS host jarak jauh yang ingin Anda sambungkan.

port
Int32

Nomor port host jarak jauh yang ingin Anda sambungkan.

Pengecualian

ArgumentNullException

Parameternya hostname adalah null.

ArgumentOutOfRangeException

Parameter port bukan antara MinPort dan MaxPort.

SocketException

Terjadi kesalahan saat mengakses soket.

ObjectDisposedException

TcpClient ditutup.

Contoh

Contoh kode berikut menggunakan nama host dan nomor port untuk terhubung dengan host jarak jauh.

//Uses a host name and port number to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
tcpClient->Connect( "www.contoso.com", 11002 );

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

Keterangan

Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke nama host dan nomor port yang ditentukan. Metode Connect ini akan memblokir hingga tersambung atau gagal. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Jika IPv6 diaktifkan dan Connect(String, Int32) metode dipanggil untuk terhubung ke host yang diselesaikan ke alamat IPv6 dan IPv4, koneksi ke alamat IPv6 akan dicoba terlebih dahulu sebelum alamat IPv4. Ini mungkin memiliki efek menunda waktu untuk membuat koneksi jika host tidak mendengarkan alamat IPv6.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Lihat juga

Berlaku untuk