UdpClient.Connect Метод

Ссылка

Определение

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

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

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

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

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

Перегрузки

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, задающий сетевую конечную точку, которую предполагается использовать для передачи данных.

Исключения

SocketException

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

ArgumentNullException

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

ObjectDisposedException

Объект 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

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

Исключения

ObjectDisposedException

UdpClient закрыт.

ArgumentNullException

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

ArgumentOutOfRangeException

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

SocketException

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

Примеры

В следующем примере используется 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, используйте метод клиента для получения базового Socketи присвойте параметру сокета значение SocketOptionName.Broadcast.

Примечание

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

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

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

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

Исключения

ObjectDisposedException

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

ArgumentOutOfRangeException

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

SocketException

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

Примеры

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

//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 метода .

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

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

Примечание

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

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

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

UdpClient.Connect Метод

Определение

Перегрузки

Connect(IPEndPoint)

Параметры

Исключения

Примеры

Комментарии

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

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

Connect(IPAddress, Int32)

Параметры

Исключения

Примеры

Комментарии

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

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

Connect(String, Int32)

Параметры

Исключения

Примеры

Комментарии

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

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

Дополнительные ресурсы