TcpClient 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 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。
存取該套接字時發生錯誤。
範例
以下程式碼範例示範如何利用主機名稱和埠號建立該 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框架中的網絡追蹤。