UdpClient.Connect Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Устанавливает удаленный узел, используемый по умолчанию.
Connect(IPEndPoint) |
Устанавливает удаленный узел по умолчанию, используя заданную сетевую конечную точку. |
Connect(IPAddress, Int32) |
Устанавливает удаленный узел по умолчанию, используя заданный IP-адрес и номер порта. |
Connect(String, Int32) |
Устанавливает удаленный узел по умолчанию, используя заданное имя узла и номер порта. |
- Исходный код:
- 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 если вы планируете получать многоадресные датаграммы.
См. также раздел
Применяется к
.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 |
- Исходный код:
- 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 = 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 если вы планируете получать многоадресные датаграммы.
См. также раздел
Применяется к
.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 |
- Исходный код:
- 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 = 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 если вы планируете получать многоадресные датаграммы.
См. также раздел
Применяется к
.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 |
.NET кері байланысы
.NET — бастапқы коды ашық жоба. Пікір қалдыру үшін сілтемені таңдаңыз: