TcpClient クラスの新しいインスタンスを初期化し、指定したホストの指定したポートに接続します。
名前空間: System.Net.Sockets
アセンブリ: System (system.dll 内)
構文
'宣言
Public Sub New ( _
hostname As String, _
port As Integer _
)
'使用
Dim hostname As String
Dim port As Integer
Dim instance As New TcpClient(hostname, port)
public TcpClient (
string hostname,
int port
)
public:
TcpClient (
String^ hostname,
int port
)
public TcpClient (
String hostname,
int port
)
public function TcpClient (
hostname : String,
port : int
)
パラメータ
- hostname
接続先のリモート ホストの DNS 名。
- port
接続先のリモート ホストのポート番号。
例外
| 例外の種類 | 条件 |
|---|---|
hostname が null 参照 (Visual Basic では Nothing) です。 |
|
ソケットへのアクセス中にエラーが発生しました。詳細については「解説」を参照してください。 |
解説
このコンストラクタは、新しい TcpClient を作成し、指定したホスト名とポート番号への同期接続を試みます。基になるサービス プロバイダは、最も適切なローカル IP アドレスおよびポート番号を割り当てます。TcpClient は接続が成功するか失敗するまでブロックします。このコンストラクタにより初期化、DNS ホスト名の解決、接続を 1 つの便利な手順で実行できます。
注意
SocketException が発生した場合は、SocketException.ErrorCode を使用して具体的なエラー コードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラー コードのマニュアルから、エラーの詳細情報を確認できます。これは MSDN から入手できます。
注意
このメンバは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。
使用例
ホスト名とポート番号を使用して TcpClient クラスのインスタンスを作成する方法を次のコード例に示します。
'Creates a TCPClient using hostname and port.
Dim tcpClientB As New 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.
TcpClient^ tcpClientB = gcnew TcpClient( "www.contoso.com",11000 );
//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient("www.contoso.com", 11000);
プラットフォーム
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照
関連項目
TcpClient クラス
TcpClient メンバ
System.Net.Sockets 名前空間
TcpClient
Connect