語言

TcpClient 建構函式

定義

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

多載

名稱 Description
TcpClient()

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

TcpClient(IPEndPoint)

初始化該類別的新實例 TcpClient 並將其綁定到指定的本地端點。

TcpClient(AddressFamily)

初始化該類別的新實例 TcpClient ,並符合指定族。

TcpClient(String, Int32)

初始化該類別的新實例 TcpClient ,並連接到指定主機上的指定埠口。

TcpClient()

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

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

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

範例

以下程式碼範例示範如何使用無參數建構子來建立新的 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 方法,才能傳送和接收資料。

Note

在 .NET Framework 中,此建構器僅適用於 IPv4 位址類型。

Note

當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 欲了解更多資訊,請參閱.NET框架中的網絡追蹤。

另請參閱

適用於

TcpClient(IPEndPoint)

來源:
TCPClient.cs
來源:
TCPClient.cs
來源:
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

IPEndPoint你綁定 TCP Socket的 。

例外狀況

參數 localEP 為 null。

範例

以下程式碼範例示範如何利用本地端點建立該 TcpClient 類別的實例。

//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下。 在呼叫這個建構器之前,你必須先建立 IPEndPoint 一個使用 IP 位址和埠號,並用來傳送和接收資料。 你不需要在連接和通訊前指定本地 IP 位址和埠號。 如果你用任何其他建構器建立 , TcpClient 底層服務提供者會分配最合適的本地 IP 位址和埠號。

你必須在傳送和接收資料前呼叫該 Connect 方法。

Note

當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 欲了解更多資訊,請參閱.NET框架中的網絡追蹤。

另請參閱

適用於

TcpClient(AddressFamily)

來源:
TCPClient.cs
來源:
TCPClient.cs
來源:
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 = new TcpClient (AddressFamily.InterNetwork);
Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

備註

Note

當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 欲了解更多資訊,請參閱.NET框架中的網絡追蹤。

適用於

TcpClient(String, Int32)

來源:
TCPClient.cs
來源:
TCPClient.cs
來源:
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 不介於 MinPort 與 MaxPort之間。

存取該套接字時發生錯誤。

範例

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

//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 位址,這可能會延遲建立連線的時間。

Note

如果您收到 SocketException,請使用 SocketException.ErrorCode 以取得特定的錯誤代碼。 取得這些程式碼後,你可以參考 Windows Sockets 版本 2 的 API 錯誤程式碼 文件,了解錯誤的詳細說明。

Note

當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 欲了解更多資訊,請參閱.NET框架中的網絡追蹤。

另請參閱

適用於