TcpClient コンストラクタ

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

TcpClient コンストラクタ (String, Int32)

TcpClient クラスの新しいインスタンスを初期化し、指定したホストの指定したポートに接続します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim hostname As String
Dim port As Integer

Dim instance As New TcpClient(hostname,
 port)

C#

public TcpClient (
    string hostname,
    int port
)

C++

public:
TcpClient (
    String^ hostname, 
    int port
)

J#

public TcpClient (
    String hostname, 
    int port
)

JScript

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

パラメータ

hostname

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

port

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

例外

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

解説

このコンストラクタは、新しい TcpClient を作成し、指定したホスト名とポート番号への同期接続を試みます。基になるサービス プロバイダは、最も適切なローカル IP アドレスおよびポート番号を割り当てます。TcpClient は接続が成功するか失敗するまでブロックします。このコンストラクタにより初期化、DNS ホスト名の解決、接続を 1 つの便利な手順で実行できます。

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

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

使用例

ホスト名とポート番号を使用して TcpClient クラスのインスタンスを作成する方法を次のコード例に示します。

Visual Basic

'Creates a TCPClient using hostname and port.

Dim tcpClientB As New TcpClient("www.contoso.com",
 11000)

C#

//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient ("www.contoso.com",
 11000);

C++

// Creates a TCPClient using hostname and port.
TcpClient^ tcpClientB = gcnew TcpClient( "www.contoso.com",11000 );

J#

//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

TcpClient コンストラクタ (IPEndPoint)

TcpClient クラスの新しいインスタンスを初期化し、指定したローカル エンドポイントにバインドします。

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

Visual Basic (宣言)

Public Sub New ( _
    localEP As IPEndPoint _
)

Visual Basic (使用法)

Dim localEP As IPEndPoint

Dim instance As New TcpClient(localEP)

C#

public TcpClient (
    IPEndPoint localEP
)

C++

public:
TcpClient (
    IPEndPoint^ localEP
)

J#

public TcpClient (
    IPEndPoint localEP
)

JScript

public function TcpClient (
    localEP : IPEndPoint
)

パラメータ

localEP

TCP Socket のバインド先の IPEndPoint。

例外

例外の種類	条件
ArgumentNullException	localEP が null 参照 (Visual Basic では Nothing) です。

解説

このコンストラクタは、新しい TcpClient を作成し、これを localEP パラメータで指定した IPEndPoint にバインドします。このコンストラクタを呼び出す前に、データの送受信を開始する IP アドレスおよびポート番号を使用して IPEndPoint を作成する必要があります。接続と通信を行う前にローカル IP アドレスおよびポート番号を指定する必要はありません。その他のコンストラクタを使用して TcpClient を作成する場合は、基になるサービス プロバイダが最も適切なローカル IP アドレスおよびポート番号を割り当てます。

このとき、データを送受信する前に、Connect メソッドを呼び出しておく必要があります。

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

使用例

ローカル エンドポイントを使用して TcpClient クラスのインスタンスを作成する方法を次のコード例に示します。

Visual Basic

'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)

C#

//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);

C++

//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 );

J#

//Creates a TCPClient using a local end point.
IPAddress ipAddress =
    Dns.Resolve(Dns.GetHostName()).get_AddressList()[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);
TcpClient tcpClientA = new TcpClient(ipLocalEndPoint);

プラットフォーム

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 クラス
Connect

TcpClient コンストラクタ (AddressFamily)

ファミリを指定して、TcpClient クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    family As AddressFamily _
)

Visual Basic (使用法)

Dim family As AddressFamily

Dim instance As New TcpClient(family)

C#

public TcpClient (
    AddressFamily family
)

C++

public:
TcpClient (
    AddressFamily family
)

J#

public TcpClient (
    AddressFamily family
)

JScript

public function TcpClient (
    family : AddressFamily
)

パラメータ

family

IP プロトコルの AddressFamily。

例外

例外の種類	条件
ArgumentException	family != AddressFamily.InterNetwork または family != AddressFamily.InterNetworkV6

解説

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

使用例

TcpClient クラスのインスタンスを作成する方法を次のコード例に示します。

Visual Basic

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

C#

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

C++

TcpClient^ tcpClientD = gcnew TcpClient( AddressFamily::InterNetwork );

J#

TcpClient tcpClientD =
    new TcpClient(AddressFamily.InterNetwork);

プラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0

参照

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

TcpClient コンストラクタ

TcpClient クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
TcpClient ()	TcpClient クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
TcpClient (AddressFamily)	ファミリを指定して、TcpClient クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
TcpClient (IPEndPoint)	TcpClient クラスの新しいインスタンスを初期化し、指定したローカル エンドポイントにバインドします。 .NET Compact Framework によってサポートされています。
TcpClient (String, Int32)	TcpClient クラスの新しいインスタンスを初期化し、指定したホストの指定したポートに接続します。 .NET Compact Framework によってサポートされています。

参照

関連項目

TcpClient クラス
TcpClient メンバ
System.Net.Sockets 名前空間
Connect

TcpClient コンストラクタ ()

TcpClient クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New TcpClient

C#

public TcpClient ()

C++

public:
TcpClient ()

J#

public TcpClient ()

JScript

public function TcpClient ()

解説

このコンストラクタは、新しい TcpClient を作成し、基になるサービス プロバイダが最も適切なローカル IP アドレスおよびポート番号を割り当てられるようにします。データを送受信するには、まず、Connect メソッドを呼び出しておく必要があります。

メモ
このコンストラクタは、IPv4 アドレス形式でだけ使用できます。

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

使用例

既定のコンストラクタを使用して新しい TcpClient を作成する方法を次のコード例に示します。

Visual Basic

'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient

C#

//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient ();

C++

//Creates a TCPClient using the default constructor.
TcpClient^ tcpClientC = gcnew TcpClient;

J#

//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient();

プラットフォーム

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 名前空間
Connect