UdpClient.Connect Метод

Определение

Устанавливает удаленный узел, используемый по умолчанию.

Перегрузки

Connect(IPEndPoint)

Устанавливает удаленный узел по умолчанию, используя заданную сетевую конечную точку.

Connect(IPAddress, Int32)

Устанавливает удаленный узел по умолчанию, используя заданный IP-адрес и номер порта.

Connect(String, Int32)

Устанавливает удаленный узел по умолчанию, используя заданное имя узла и номер порта.

Connect(IPEndPoint)

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

Устанавливает удаленный узел по умолчанию, используя заданную сетевую конечную точку.

public void Connect (System.Net.IPEndPoint endPoint);

Параметры

endPoint
IPEndPoint

Объект IPEndPoint, задающий сетевую конечную точку, которую предполагается использовать для передачи данных.

Исключения

Произошла ошибка при обращении к сокету.

endPoint имеет значение null.

Объект UdpClient закрыт.

Примеры

В следующем примере используется IPEndPoint для установки удаленного узла по умолчанию.

//Uses a remote endpoint to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);
try{
 udpClient.Connect(ipEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

Комментарии

Метод Connect устанавливает удаленный узел по умолчанию, используя значение, указанное в параметре endPoint . После установки не нужно указывать удаленный узел в каждом вызове Send метода .

Установка удаленного узла по умолчанию необязательна. Указание удаленного узла по умолчанию ограничивает только этот узел. Если вы хотите отправить датаграммы на другой удаленный узел, необходимо выполнить еще один вызов Connect метода или создать другой UdpClient без удаленного узла по умолчанию. Если вы установили удаленный узел по умолчанию и также предоставили удаленный узел в вызове Send метода , Send вызовет исключение SocketException. Если вы получаете SocketException, используйте SocketException.ErrorCode для получения определенного кода ошибки. Получив этот код, вы можете обратиться к документации по коду ошибки API сокетов Windows версии 2 , чтобы получить подробное описание ошибки.

При вызове Connect метода все датаграммы, поступающие с адреса, отличного от указанного по умолчанию, будут удалены. Вы не можете задать для удаленного узла по умолчанию широковещательный адрес с помощью этого метода, если вы не наследуете от UdpClient, используйте метод Client для получения базового Socketи задайте для параметра сокета значение SocketOptionName.Broadcast.

Однако вы можете транслировать данные по адресу широковещательной передачи по умолчанию 255.255.255.255, если вы указываете IPAddress.Broadcast в вызове Send метода . Если приложению требуется больший контроль над широковещательными адресами, можно также отменить изменения к использованию Socket класса .

Ескерім

Так как протокол UDP не подключен, Connect метод не блокируется. Не вызывайте метод , Connect если вы планируете получать многоадресные датаграммы.

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

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.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

Connect(IPAddress, Int32)

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

Устанавливает удаленный узел по умолчанию, используя заданный IP-адрес и номер порта.

public void Connect (System.Net.IPAddress addr, int port);

Параметры

addr
IPAddress

Объект IPAddress удаленного узла, которому предполагается передавать данные.

port
Int32

Номер порта, на который предполагается передавать данные.

Исключения

addr имеет значение null.

Значение параметра port не находится в диапазоне между значениями MinPort и MaxPort.

Произошла ошибка при обращении к сокету.

Примеры

В следующем примере используется IP-адрес и номер порта для подключения к удаленному узлу.

//Uses the IP address and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
try{
    udpClient.Connect(ipAddress, 11003);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

Комментарии

Метод Connect устанавливает удаленный узел по умолчанию, используя значения, указанные в параметрах addr и port . После установки не нужно указывать удаленный узел в каждом вызове Send метода .

Установка удаленного узла по умолчанию необязательна. Указание удаленного узла по умолчанию ограничивает только этот узел. Если вы хотите отправить датаграммы на другой удаленный узел, необходимо выполнить еще один вызов Connect метода или создать другой UdpClient без удаленного узла по умолчанию. Если вы установили удаленный узел по умолчанию и также предоставили удаленный узел в вызове Send метода , Send вызовет исключение SocketException. Если вы получаете SocketException, используйте SocketException.ErrorCode для получения определенного кода ошибки. Получив этот код, вы можете обратиться к документации по коду ошибки API сокетов Windows версии 2 , чтобы получить подробное описание ошибки.

При вызове Connect метода все датаграммы, поступающие с адреса, отличного от указанного по умолчанию, будут удалены. Вы не можете задать для удаленного узла по умолчанию широковещательный адрес с помощью этого метода, если вы не наследуете от UdpClient, используйте метод клиента для получения базового Socketи присвойте параметру сокета значение SocketOptionName.Broadcast.

Однако вы можете транслировать данные по адресу широковещательной передачи по умолчанию 255.255.255.255, если вы указываете IPAddress.Broadcast в вызове Send метода . Если приложению требуется больший контроль над широковещательными адресами, можно также отменить изменения к использованию Socket класса .

Ескерім

Так как протокол UDP не подключен, Connect метод не блокируется. Не вызывайте метод , Connect если вы планируете получать многоадресные датаграммы.

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

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.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

Connect(String, Int32)

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

Устанавливает удаленный узел по умолчанию, используя заданное имя узла и номер порта.

public void Connect (string hostname, int port);

Параметры

hostname
String

DNS-имя удаленного узла, на который предполагается передавать данные.

port
Int32

Имя порта удаленного узла, на который предполагается передавать данные.

Исключения

Объект UdpClient закрыт.

Значение параметра port не находится в диапазоне между значениями MinPort и MaxPort.

Произошла ошибка при обращении к сокету.

Примеры

В следующем примере для подключения к удаленному узлу используются имя узла и номер порта.

 //Uses a host name and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
try{
    udpClient.Connect("www.contoso.com", 11002);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

Комментарии

Метод Connect устанавливает удаленный узел по умолчанию, используя значения, указанные в параметрах port и hostname . После установки не нужно указывать удаленный узел в каждом вызове Send метода .

Установка удаленного узла по умолчанию необязательна. Указание удаленного узла по умолчанию ограничивает только этот узел. Если вы хотите отправить датаграммы на другой удаленный узел, необходимо выполнить еще один вызов Connect метода или создать другой UdpClient без удаленного узла по умолчанию.

Если вы установили удаленный узел по умолчанию и также предоставили удаленный узел в вызове Send метода , Send вызовет исключение SocketException. Если вы получаете SocketException, используйте SocketException.ErrorCode для получения определенного кода ошибки. Получив этот код, вы можете обратиться к документации по коду ошибки API сокетов Windows версии 2 , чтобы получить подробное описание ошибки.

При вызове Connect метода все датаграммы, поступающие с адреса, отличного от указанного по умолчанию, будут удалены. Вы не можете задать для удаленного узла по умолчанию широковещательный адрес с помощью этого метода, если вы не наследуете от UdpClient, используйте метод клиента для получения базового Socketи присвойте параметру сокета значение SocketOptionName.Broadcast.

Однако вы можете транслировать данные по адресу широковещательной передачи по умолчанию 255.255.255.255, если вы указываете IPAddress.Broadcast в вызове Send метода . Если приложению требуется больший контроль над широковещательными адресами, можно также отменить изменения к использованию Socket класса .

Ескерім

Так как протокол UDP не подключен, Connect метод не блокируется. Не вызывайте метод , Connect если вы планируете получать многоадресные датаграммы.

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

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.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