TcpClient Конструкторы

Ссылка

Определение

Пространство имен:: System.Net.Sockets

Сборки:: netstandard.dll, System.Net.Sockets.dll

Сборка:: System.Net.Sockets.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Инициализирует новый экземпляр класса TcpClient.

Перегрузки

TcpClient()	Инициализирует новый экземпляр класса TcpClient.
TcpClient(IPEndPoint)	Инициализирует новый экземпляр класса TcpClient и связывает его с заданной локальной конечной точкой.
TcpClient(AddressFamily)	Инициализирует новый экземпляр класса TcpClient с заданным семейством.
TcpClient(String, Int32)	Инициализирует новый экземпляр класса TcpClient и подключает его к указанному порту заданного узла.

TcpClient()

Исходный код:: TCPClient.cs

Исходный код:: TCPClient.cs

Исходный код:: 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)

Применяется к

.NET 10 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1

TcpClient(IPEndPoint)

Исходный код:: TCPClient.cs

Исходный код:: TCPClient.cs

Исходный код:: 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 10 и другие версии

Продукт	Версии
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

TcpClient(AddressFamily)

Исходный код:: TCPClient.cs

Исходный код:: TCPClient.cs

Исходный код:: 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 10 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1

TcpClient(String, Int32)

Исходный код:: TCPClient.cs

Исходный код:: TCPClient.cs

Исходный код:: 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 10 и другие версии

Продукт	Версии
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.

Отзыв о .NET

.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:

Открыть проблему с документацией Отзыв о продукте

Будущее в ваших руках

Поделиться через

TcpClient Конструкторы

Определение

Перегрузки

TcpClient()

Примеры

Комментарии

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

Применяется к

TcpClient(IPEndPoint)

Параметры

Исключения

Примеры

Комментарии

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

Применяется к

TcpClient(AddressFamily)

Параметры

Исключения

Примеры

Комментарии

Применяется к

TcpClient(String, Int32)

Параметры

Исключения

Примеры

Комментарии

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

Применяется к