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

Объект IPEndPoint, с которым связан объект Socket, работающий по протоколу TCP.

Исключения

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 . Перед вызовом этого конструктора необходимо создать IPEndPoint , используя IP-адрес и номер порта, с которых планируется отправлять и получать данные. Вам не нужно указывать локальный 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

Параметр AddressFamily протокола IP.

Исключения

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 для получения определенного кода ошибки. Получив этот код, вы можете ознакомиться с документацией по коду ошибок API сокетов Windows версии 2 , чтобы получить подробное описание ошибки.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в разделе Трассировка сети в платформа .NET Framework.

См. также раздел

• TcpClient
• Connect(String, Int32)