TcpClient コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
TcpClient クラスの新しいインスタンスを初期化します。
オーバーロード
| 名前 | 説明 |
|---|---|
| TcpClient() |
TcpClient クラスの新しいインスタンスを初期化します。 |
| TcpClient(IPEndPoint) |
TcpClient クラスの新しいインスタンスを初期化し、指定したローカル エンドポイントにバインドします。 |
| TcpClient(AddressFamily) |
指定したファミリを使用して、 TcpClient クラスの新しいインスタンスを初期化します。 |
| TcpClient(String, Int32) |
TcpClient クラスの新しいインスタンスを初期化し、指定したホスト上の指定したポートに接続します。 |
TcpClient()
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 Framework の Network Tracingを参照してください。
こちらもご覧ください
適用対象
TcpClient(IPEndPoint)
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。
例外
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を作成し、localEP パラメーターで指定されたIPEndPointにバインドします。 このコンストラクターを呼び出す前に、データの送受信元となる IP アドレスとポート番号を使用して IPEndPoint を作成する必要があります。 接続して通信する前に、ローカル IP アドレスとポート番号を指定する必要はありません。 他のコンストラクターを使用して TcpClient を作成すると、基になるサービス プロバイダーによって、最も適切なローカル IP アドレスとポート番号が割り当てられます。
データを送受信する前に、 Connect メソッドを呼び出す必要があります。
Note
このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「.NET Framework の Network Tracingを参照してください。
こちらもご覧ください
適用対象
TcpClient(AddressFamily)
指定したファミリを使用して、 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 Framework の Network Tracingを参照してください。
適用対象
TcpClient(String, Int32)
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 は、接続または失敗するまでブロックされます。 このコンストラクターを使用すると、1 つの便利な手順で、初期化、DNS ホスト名の解決、接続を行うことができます。
IPv6 が有効になっていて、IPv6 アドレスと IPv4 アドレスの両方に解決されるホストに接続するために TcpClient(String, Int32) メソッドが呼び出された場合、IPv6 アドレスへの接続は、IPv4 アドレスの前に最初に試行されます。 これは、ホストが IPv6 アドレスをリッスンしていない場合に、接続を確立する時間を遅らせる効果がある可能性があります。
Note
SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得した後、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「.NET Framework の Network Tracingを参照してください。