TcpClient 建構函式

定義

命名空間:

System.Net.Sockets

組件:

System.Net.Sockets.dll

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

多載

TcpClient()	初始化 TcpClient 類別的新執行個體。
TcpClient(IPEndPoint)	初始化 TcpClient 類別的新執行個體，並將它繫結至指定的本機端點。
TcpClient(AddressFamily)	使用指定的家族，初始化 TcpClient 類別的新執行個體。
TcpClient(String, Int32)	初始化 TcpClient 類別的新執行個體，並將它連接至指定主機的指定連接埠。

TcpClient()

來源:

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 中的網路追蹤。

另請參閱

• Connect(String, Int32)

TcpClient(IPEndPoint)

來源:

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 Socket 的 IPEndPoint。

例外狀況

ArgumentNullException

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 中的網路追蹤。

另請參閱

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

來源:

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。

例外狀況

ArgumentException

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 類別的新執行個體，並將它連接至指定主機的指定連接埠。

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

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

例外狀況

ArgumentNullException

hostname 參數為 null。

ArgumentOutOfRangeException

port 參數不是介於 MinPort 和 MaxPort。

SocketException

存取通訊端時發生錯誤。

範例

下列程式代碼範例示範如何使用主機名和埠號碼來建立 類別的 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 中的網路追蹤。

另請參閱

• TcpClient
• Connect(String, Int32)