UdpClient.Connect Метод

Определение

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

Перегрузки

Имя Описание
Connect(IPEndPoint)

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

Connect(IPAddress, Int32)

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

Connect(String, Int32)

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

Connect(IPEndPoint)

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

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

public:
 void Connect(System::Net::IPEndPoint ^ endPoint);
public void Connect(System.Net.IPEndPoint endPoint);
member this.Connect : System.Net.IPEndPoint -> unit
Public Sub Connect (endPoint As IPEndPoint)

Параметры

endPoint
IPEndPoint

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

Исключения

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

endPoint равно null.

Примеры

В следующем примере используется для 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());
       }
'Uses a remote endpoint to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)
Try
   udpClient.Connect(ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Комментарии

Метод 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 класса.

Note

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

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

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

Connect(IPAddress, Int32)

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

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

public:
 void Connect(System::Net::IPAddress ^ addr, int port);
public void Connect(System.Net.IPAddress addr, int port);
member this.Connect : System.Net.IPAddress * int -> unit
Public Sub Connect (addr As IPAddress, port As Integer)

Параметры

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());
}
'Uses the IP address and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Try
   udpClient.Connect(ipAddress, 11003)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Комментарии

Метод 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 класса.

Note

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

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

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

Connect(String, Int32)

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

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

public:
 void Connect(System::String ^ hostname, int port);
public void Connect(string hostname, int port);
member this.Connect : string * int -> unit
Public Sub Connect (hostname As String, port As Integer)

Параметры

hostname
String

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

port
Int32

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

Исключения

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());
       }
'Uses a host name and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Try
   udpClient.Connect("www.contoso.com", 11002)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Комментарии

Метод 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 класса.

Note

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

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

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