TcpClient.Connectとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

TcpClient.Connect メソッド (String, Int32)

指定されたホストの指定されたポートにクライアントを接続します。

名前空間: System.Net.Sockets
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub Connect ( _
    hostname As String, _
    port As Integer _
)

Visual Basic (使用法)

Dim instance As TcpClient
Dim hostname As String
Dim port As Integer

instance.Connect(hostname, port)

public void Connect (
    string hostname,
    int port
)

C++

public:
void Connect (
    String^ hostname, 
    int port
)

public void Connect (
    String hostname, 
    int port
)

JScript

public function Connect (
    hostname : String, 
    port : int
)

パラメータ

hostname: 接続先のリモートホストの DNS 名。

port: 接続先のリモートホストのポート番号。

例外

例外の種類	条件
ArgumentNullException	hostname が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	port が MinPort と MaxPort の間の値ではありません。
SocketException	ソケットへのアクセス中にエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	TcpClient が閉じています。

解説

このメソッドを呼び出して、指定したホスト名およびポート番号への同期リモートホスト接続を確立します。Connect メソッドは、接続するか失敗するまでブロックします。リモートホストに接続した後、GetStream メソッドを使用して、基になっている NetworkStream を取得します。この NetworkStream を使用して、データを送受信します。

メモ
SocketException が発生した場合は、SocketException.ErrorCode を使用して具体的なエラーコードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラーコードのマニュアルから、エラーの詳細情報を確認できます。これは MSDN から入手できます。

メモ
このメンバは、アプリケーションでネットワークトレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

ホスト名とポート番号を使用してリモートホストと接続するコード例を次に示します。

Visual Basic

'Uses a host name and port number to establish a socket connection.
Dim tcpClient As New TcpClient()

   tcpClient.Connect("www.contoso.com", 11002)

//Uses a host name and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
tcpClient.Connect ("www.contoso.com", 11002);

C++

//Uses a host name and port number to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
tcpClient->Connect( "www.contoso.com", 11002 );

//Uses a host name and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient();
tcpClient.Connect("www.contoso.com", 11002);

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
TcpClient クラス
TcpClient メンバ
System.Net.Sockets 名前空間
Connect
GetStream

TcpClient.Connect メソッド (IPEndPoint)

指定されたリモートネットワークエンドポイントを使用してリモート TCP ホストにクライアントを接続します。

名前空間: System.Net.Sockets
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub Connect ( _
    remoteEP As IPEndPoint _
)

Visual Basic (使用法)

Dim instance As TcpClient
Dim remoteEP As IPEndPoint

instance.Connect(remoteEP)

public void Connect (
    IPEndPoint remoteEP
)

C++

public:
void Connect (
    IPEndPoint^ remoteEP
)

public void Connect (
    IPEndPoint remoteEP
)

JScript

public function Connect (
    remoteEP : IPEndPoint
)

パラメータ

remoteEP: 接続先の IPEndPoint。

例外

例外の種類	条件
ArgumentNullException	remoteEp が null 参照 (Visual Basic では Nothing) です。
SocketException	ソケットへのアクセス中にエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	TcpClient が閉じています。

解説

このメソッドを呼び出して、指定した IPEndPoint への同期リモートホスト接続を確立します。Connect を呼び出す前に、IP アドレスとポート番号を使用して IPEndPoint クラスのインスタンスを作成しておく必要があります。この IPEndPoint を remoteEP パラメータとして使用します。Connect メソッドは、接続するか失敗するまでブロックします。リモートホストに接続した後、GetStream メソッドを使用して、基になっている NetworkStream を取得します。この NetworkStream を使用して、データを送受信します。

メモ
SocketException が発生した場合は、SocketException.ErrorCode を使用して具体的なエラーコードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラーコードのマニュアルから、エラーの詳細情報を確認できます。これは MSDN から入手できます。

メモ
このメンバは、アプリケーションでネットワークトレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

IPEndPoint を使用してリモートホストと接続するコード例を次に示します。

Visual Basic

'Uses a remote endpoint to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress,
 11004)

tcpClient.Connect(ipEndPoint)

//Uses a remote endpoint to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint (ipAddress, 11004);

tcpClient.Connect (ipEndPoint);

C++

//Uses a remote end point to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[
 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
tcpClient->Connect( ipEndPoint );

//Uses a remote end point to establish a socket connection.
TcpClient tcpClient = new TcpClient();
IPAddress ipAddress =
    Dns.Resolve("www.contoso.com").get_AddressList()[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);

tcpClient.Connect(ipEndPoint);

プラットフォーム

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 名前空間
IPEndPoint クラス
GetStream

TcpClient.Connect メソッド (IPAddress, Int32)

指定された IP アドレスとポート番号を使用してクライアントをリモート TCP ホストと接続します。

名前空間: System.Net.Sockets
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub Connect ( _
    address As IPAddress, _
    port As Integer _
)

Visual Basic (使用法)

Dim instance As TcpClient
Dim address As IPAddress
Dim port As Integer

instance.Connect(address, port)

public void Connect (
    IPAddress address,
    int port
)

C++

public:
void Connect (
    IPAddress^ address, 
    int port
)

public void Connect (
    IPAddress address, 
    int port
)

JScript

public function Connect (
    address : IPAddress, 
    port : int
)

パラメータ

address: 接続先ホストの IPAddress。

port: 接続先のポート番号。

例外

例外の種類	条件
ArgumentNullException	address パラメータが null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	port が MinPort と MaxPort の間の値ではありません。
SocketException	ソケットへのアクセス中にエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	TcpClient が閉じています。

解説

このメソッドを呼び出して、指定した IPAddress およびポート番号への同期リモートホスト接続を確立します。Connect メソッドは、接続するか失敗するまでブロックします。リモートホストに接続した後、GetStream メソッドを使用して、基になっている NetworkStream を取得します。この NetworkStream を使用して、データを送受信します。

メモ
SocketException が発生した場合は、SocketException.ErrorCode を使用して具体的なエラーコードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラーコードのマニュアルから、エラーの詳細情報を確認できます。これは MSDN から入手できます。

メモ
このメンバは、アプリケーションでネットワークトレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

IP アドレスとポート番号を使用してリモートホストと接続するコード例を次に示します。

Visual Basic

'Uses the IP address and port number to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
tcpClient.Connect(ipAddress, 11003)

//Uses the IP address and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];

tcpClient.Connect (ipAddress, 11003);

C++

//Uses the IP address and port number to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[
 0 ];
tcpClient->Connect( ipAddress, 11003 );

//Uses the IP address and port number to establish a socket
// connection.
TcpClient tcpClient = new TcpClient();
IPAddress ipAddress =
    Dns.Resolve("www.contoso.com").get_AddressList()[0];

tcpClient.Connect(ipAddress, 11003);

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
TcpClient クラス
TcpClient メンバ
System.Net.Sockets 名前空間
GetStream

TcpClient.Connect メソッド

指定されたホスト名とポート番号を使用してクライアントをリモート TCP ホストに接続します。
オーバーロードの一覧

名前	説明
TcpClient.Connect (IPEndPoint)	指定されたリモートネットワークエンドポイントを使用してリモート TCP ホストにクライアントを接続します。 .NET Compact Framework によってサポートされています。
TcpClient.Connect (IPAddress, Int32)	指定された IP アドレスとポート番号を使用してクライアントをリモート TCP ホストと接続します。 .NET Compact Framework によってサポートされています。
TcpClient.Connect (IPAddress[], Int32)	指定された IP アドレスとポート番号を使用してクライアントをリモート TCP ホストと接続します。
TcpClient.Connect (String, Int32)	指定されたホストの指定されたポートにクライアントを接続します。 .NET Compact Framework によってサポートされています。

参照

TcpClient.Connect メソッド (IPAddress[], Int32)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定された IP アドレスとポート番号を使用してクライアントをリモート TCP ホストと接続します。

名前空間: System.Net.Sockets
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub Connect ( _
    ipAddresses As IPAddress(), _
    port As Integer _
)

Visual Basic (使用法)

Dim instance As TcpClient
Dim ipAddresses As IPAddress()
Dim port As Integer

instance.Connect(ipAddresses, port)

public void Connect (
    IPAddress[] ipAddresses,
    int port
)

C++

public:
void Connect (
    array<IPAddress^>^ ipAddresses, 
    int port
)

public void Connect (
    IPAddress[] ipAddresses, 
    int port
)

JScript

public function Connect (
    ipAddresses : IPAddress[], 
    port : int
)

パラメータ

ipAddresses: 接続先ホストの IPAddress 配列。

port: 接続先のポート番号。

例外

例外の種類	条件
ArgumentNullException	ipAddresses パラメータが null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	ポート番号が無効です。
SocketException	ソケットへのアクセスを試みているときにエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	Socket は閉じられています。
SecurityException	コールスタックの上位にある呼び出し元が、要求された操作のアクセス許可を保持していません。
NotSupportedException	このメソッドは、InterNetwork フラグまたは InterNetworkV6 フラグを使用するソケットで有効です。

解説

通常、このメソッドは ResolveToAddresses メソッドを呼び出した直後に使用され、単一のホストに対する複数の IP アドレスを返すことができます。Connect メソッドを呼び出して、IPAddress 要素の配列とポート番号で指定されたホストへの同期リモートホスト接続を確立します。Connect メソッドは、接続するか失敗するまでブロックします。リモートホストに接続した後、GetStream メソッドを使用して、基になっている NetworkStream を取得します。この NetworkStream を使用して、データを送受信します。

メモ
SocketException が発生した場合は、SocketException.ErrorCode を使用して具体的なエラーコードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラーコードのマニュアルからエラーの詳細情報を確認してください。これは MSDN ライブラリ (http://msdn.microsoft.com/library/ja) から入手できます。

メモ

SocketException が発生した場合は、SocketException.ErrorCode を使用して具体的なエラーコードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラーコードのマニュアルからエラーの詳細情報を確認してください。これは MSDN ライブラリ (http://msdn.microsoft.com/library/ja) から入手できます。

メモ
このメンバは、アプリケーションでネットワークトレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

IP アドレスとポート番号を使用してリモートホストと接続するコード例を次に示します。

static void DoConnect(string
 host, int port)
{
    // Connect to the specified host.
    TcpClient t = new TcpClient(AddressFamily.InterNetwork);
      
    IPAddress[] IPAddresses = Dns.GetHostAddresses(host);

    Console.WriteLine("Establishing connection to {0}", host);
    t.Connect(IPAddresses, port);

    Console.WriteLine("Connection established");
}

C++

static void DoConnect( String^ host, int
 port )
{
   // Connect to the specified host.
   TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
   array<IPAddress^>^IPAddresses = Dns::GetHostAddresses( host );
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->Connect( IPAddresses, port );
   Console::WriteLine( "Connection established" );
}