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.
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());
}
'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)
Параметры
- port
- Int32
Номер порта, в который планируется отправить данные.
Исключения
UdpClient закрыт.
addr равно null.
При доступе к сокету произошла ошибка.
Примеры
В следующем примере для подключения к удаленному узлу используется 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
Номер порта на удаленном узле, на котором планируется отправлять данные.
Исключения
UdpClient закрыт.
При доступе к сокету произошла ошибка.
Примеры
В следующем примере для подключения к удаленному узлу используется имя узла и номер порта.
//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 если планируется получать многоадресные диаграммы данных.