TcpClient 建構函式

定義

初始化 TcpClient 類別的新執行個體。

多載

TcpClient()

初始化 TcpClient 類別的新執行個體。

TcpClient(IPEndPoint)

初始化 TcpClient 類別的新執行個體,並將它繫結至指定的本機端點。

TcpClient(AddressFamily)

使用指定的家族,初始化 TcpClient 類別的新執行個體。

TcpClient(String, Int32)

初始化 TcpClient 類別的新執行個體,並將它連接至指定主機的指定連接埠。

TcpClient()

來源:
TCPClient.cs
來源:
TCPClient.cs
來源:
TCPClient.cs

初始化 TcpClient 類別的新執行個體。

public:
 TcpClient();
public TcpClient ();
Public Sub New ()

範例

下列程式碼範例示範如何使用無參數建構函式來建立新的 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

備註

此建構函式會建立新的 TcpClient ,並允許基礎服務提供者指派最適當的本機 IP 位址和埠號碼。 您必須先呼叫 方法, Connect 才能傳送和接收資料。

注意

在.NET Framework上,此建構函式只適用于 IPv4 網址類別型。

注意

在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework中的網路追蹤

另請參閱

適用於

TcpClient(IPEndPoint)

來源:
TCPClient.cs
來源:
TCPClient.cs
來源:
TCPClient.cs

初始化 TcpClient 類別的新執行個體,並將它繫結至指定的本機端點。

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)

參數

localEP
IPEndPoint

您要繫結 TCP SocketIPEndPoint

例外狀況

localEP 參數為 null

範例

下列程式碼範例示範如何使用本機端點建立 類別的 TcpClient 實例。

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

備註

此建構函式會建立新的 TcpClient ,並將它系結至 IPEndPoint 參數所 localEP 指定的 。 呼叫這個建構函式之前,您必須使用您想要從中傳送和接收資料的 IP 位址和埠號碼來建立 IPEndPoint 。 在連線和通訊之前,您不需要指定本機 IP 位址和埠號碼。 如果您使用任何其他建構函式建立 TcpClient ,基礎服務提供者將會指派最適當的本機 IP 位址和埠號碼。

您必須先呼叫 方法, Connect 才能傳送和接收資料。

注意

在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework中的網路追蹤

另請參閱

適用於

TcpClient(AddressFamily)

來源:
TCPClient.cs
來源:
TCPClient.cs
來源:
TCPClient.cs

使用指定的家族,初始化 TcpClient 類別的新執行個體。

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)

參數

family
AddressFamily

IP 通訊協定的 AddressFamily

例外狀況

family 參數不等於 AddressFamily.InterNetwork

-或-

family 參數不等於 AddressFamily.InterNetworkV6

範例

下列程式碼範例示範如何建立 類別的 TcpClient 實例。

TcpClient^ tcpClientD = gcnew TcpClient( AddressFamily::InterNetwork );
TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);
Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

備註

注意

在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework中的網路追蹤

適用於

TcpClient(String, Int32)

來源:
TCPClient.cs
來源:
TCPClient.cs
來源:
TCPClient.cs

初始化 TcpClient 類別的新執行個體,並將它連接至指定主機的指定連接埠。

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)

參數

hostname
String

您要連接之遠端主機的 DNS 名稱。

port
Int32

您要連接之遠端主機的連接埠號碼。

例外狀況

hostname 參數為 null

port 參數不是介於 MinPortMaxPort

存取通訊端時發生錯誤。

範例

下列程式碼範例示範如何使用主機名稱和埠號碼建立 類別的 TcpClient 實例。

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

備註

此建構函式會建立新的 TcpClient ,並嘗試同步連線至提供的主機名稱和埠號碼。 基礎服務提供者會指派最適當的本機 IP 位址和埠號碼。 TcpClient 將會封鎖,直到連線或失敗為止。 此建構函式可讓您初始化、解析 DNS 主機名稱,並在一個方便的步驟中連線。

如果已啟用 IPv6 並 TcpClient(String, Int32) 呼叫 方法來連線到解析為 IPv6 和 IPv4 位址的主機,則會先嘗試連線到 IPv6 位址,再嘗試 IPv4 位址。 如果主機未接聽 IPv6 位址,這可能會延遲建立連線的時間。

注意

如果您收到 SocketException ,請使用 SocketException.ErrorCode 來取得特定的錯誤碼。 取得此程式碼之後,您可以參閱 Windows Sockets 第 2 版 API 錯誤碼 檔,以取得錯誤的詳細描述。

注意

在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework中的網路追蹤

另請參閱

適用於