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);
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 = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
try
{
   udpClient->Connect( ipEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}
//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 класса .

Примечание

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

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

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

Connect(IPAddress, Int32)

Исходный код:
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 = gcnew 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.
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 класса .

Примечание

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

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

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

Connect(String, Int32)

Исходный код:
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 закрыт.

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

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

Примеры

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

//Uses a host name and port number to establish a socket connection.
UdpClient^ udpClient = gcnew 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.
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 класса .

Примечание

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

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

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