TcpClient Konstruktor

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

System.Net.Sockets.dll

Menginisialisasi instans baru kelas TcpClient.

Overload

TcpClient()	Menginisialisasi instans baru kelas TcpClient.
TcpClient(IPEndPoint)	Menginisialisasi instans TcpClient baru kelas dan mengikatnya ke titik akhir lokal yang ditentukan.
TcpClient(AddressFamily)	Menginisialisasi instans TcpClient baru kelas dengan keluarga yang ditentukan.
TcpClient(String, Int32)	Menginisialisasi instans TcpClient baru kelas dan menyambungkan ke port yang ditentukan pada host yang ditentukan.

TcpClient()

Sumber:

TCPClient.cs

Menginisialisasi instans baru kelas TcpClient.

public:
 TcpClient();

public TcpClient ();

Public Sub New ()

Contoh

Contoh kode berikut menunjukkan cara menggunakan konstruktor tanpa parameter untuk membuat .TcpClient

//Creates a TCPClient using the default constructor.
TcpClient^ tcpClientC = gcnew TcpClient;

//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient ();

'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient

Keterangan

Konstruktor ini membuat yang baru TcpClient dan memungkinkan penyedia layanan yang mendasar untuk menetapkan alamat IP lokal dan nomor port yang paling tepat. Anda harus terlebih dahulu Connect memanggil metode sebelum mengirim dan menerima data.

Catatan

Pada .NET Framework, konstruktor ini hanya berfungsi dengan jenis alamat IPv4.

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

• Connect(String, Int32)

TcpClient(IPEndPoint)

Sumber:

TCPClient.cs

Menginisialisasi instans TcpClient baru kelas dan mengikatnya ke titik akhir lokal yang ditentukan.

public:
 TcpClient(System::Net::IPEndPoint ^ localEP);

public TcpClient (System.Net.IPEndPoint localEP);

new System.Net.Sockets.TcpClient : System.Net.IPEndPoint -> System.Net.Sockets.TcpClient

Public Sub New (localEP As IPEndPoint)

Parameter

localEP

IPEndPoint

yang IPEndPoint Anda ikat TCP Socket.

Pengecualian

ArgumentNullException

Parameternya localEP adalah null.

Contoh

Contoh kode berikut menunjukkan cara membuat instans TcpClient kelas menggunakan titik akhir lokal.

//Creates a TCPClient using a local end point.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );
TcpClient^ tcpClientA = gcnew TcpClient( ipLocalEndPoint );

//Creates a TCPClient using a local end point.
IPAddress ipAddress = Dns.GetHostEntry (Dns.GetHostName ()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 0);
TcpClient tcpClientA = new TcpClient (ipLocalEndPoint);

'Creates a TCPClient using a local endpoint.
Dim ipAddress As IPAddress = Dns.GetHostEntry(Dns.GetHostName()).AddressList(0)
   Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 0)

   Dim tcpClientA As New TcpClient(ipLocalEndPoint)

Keterangan

Konstruktor ini membuat baru TcpClient dan mengikatnya ke IPEndPoint yang ditentukan oleh localEP parameter . Sebelum memanggil konstruktor ini, Anda harus membuat IPEndPoint menggunakan alamat IP dan nomor port tempat Anda ingin mengirim dan menerima data. Anda tidak perlu menentukan alamat IP lokal dan nomor port sebelum menyambungkan dan berkomunikasi. Jika Anda membuat TcpClient menggunakan konstruktor lain, penyedia layanan yang mendasar akan menetapkan alamat IP lokal dan nomor port yang paling sesuai.

Anda harus memanggil Connect metode sebelum mengirim dan menerima data.

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

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

Sumber:

TCPClient.cs

Menginisialisasi instans TcpClient baru kelas dengan keluarga yang ditentukan.

public:
 TcpClient(System::Net::Sockets::AddressFamily family);

public TcpClient (System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.TcpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.TcpClient

Public Sub New (family As AddressFamily)

Parameter

family

AddressFamily

Protokol AddressFamily IP.

Pengecualian

ArgumentException

Parameter family tidak sama dengan AddressFamily.InterNetwork

-atau-

Parameter family tidak sama dengan AddressFamily.InterNetworkV6

Contoh

Contoh kode berikut menunjukkan cara membuat instans TcpClient kelas.

TcpClient^ tcpClientD = gcnew TcpClient( AddressFamily::InterNetwork );

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Keterangan

Catatan

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

TcpClient(String, Int32)

Sumber:

TCPClient.cs

Menginisialisasi instans TcpClient baru kelas dan menyambungkan ke port yang ditentukan pada host yang ditentukan.

public:
 TcpClient(System::String ^ hostname, int port);

public TcpClient (string hostname, int port);

new System.Net.Sockets.TcpClient : string * int -> System.Net.Sockets.TcpClient

Public Sub New (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.

Contoh

Contoh kode berikut menunjukkan cara membuat instans TcpClient kelas menggunakan nama host dan nomor port.

// Creates a TCPClient using hostname and port.
TcpClient^ tcpClientB = gcnew TcpClient( "www.contoso.com",11000 );

//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient ("www.contoso.com", 11000);

'Creates a TCPClient using hostname and port.

Dim tcpClientB As New TcpClient("www.contoso.com", 11000)

Keterangan

Konstruktor ini membuat baru TcpClient dan membuat upaya koneksi sinkron ke nama host dan nomor port yang disediakan. Penyedia layanan yang mendasar akan menetapkan alamat IP lokal dan nomor port yang paling tepat. TcpClient akan memblokir hingga tersambung atau gagal. Konstruktor ini memungkinkan Anda untuk menginisialisasi, menyelesaikan nama host DNS, dan menyambungkan dalam satu langkah yang nyaman.

Jika IPv6 diaktifkan dan TcpClient(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

• TcpClient
• Connect(String, Int32)