UdpClient.Connect 方法

定义

命名空间:: System.Net.Sockets

程序集:: netstandard.dll, System.Net.Sockets.dll

程序集:: System.Net.Sockets.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

建立默认远程主机。

重载

名称	说明
Connect(IPEndPoint)	使用指定的网络终结点建立默认远程主机。
Connect(IPAddress, Int32)	使用指定的 IP 地址和端口号建立默认远程主机。
Connect(String, Int32)	使用指定的主机名和端口号建立默认远程主机。

Connect(IPEndPoint)

Source:: UDPClient.cs

Source:: UDPClient.cs

Source:: UDPClient.cs

Source:: UDPClient.cs

Source:: 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 = 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 获取特定错误代码。获取此代码后，可以参阅 Windows 套接字版本 2 API 错误代码文档，获取错误的详细说明。

如果调用 Connect 该方法，则从指定默认值以外的地址到达的任何数据报将被丢弃。除非继承自 UdpClient，否则不能使用此方法将默认远程主机设置为广播地址，请使用 Client 方法获取基础 Socket，并将套接字选项设置为 SocketOptionName.Broadcast。

但是，如果在调用IPAddress.Broadcast方法时指定Send，可以将数据广播到默认广播地址 255.255.255.255。如果应用程序需要更好地控制广播地址，则还可以还原为使用该 Socket 类。

注释

由于 UDP 协议是无连接的， Connect 因此该方法不会阻止。如果要接收多播数据报，请不要调用 Connect 该方法。

另请参阅

适用于

Connect(IPAddress, Int32)

Source:: UDPClient.cs

Source:: UDPClient.cs

Source:: UDPClient.cs

Source:: UDPClient.cs

Source:: 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 = 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。

注释

由于 UDP 协议是无连接的， Connect 因此该方法不会阻止。如果要接收多播数据报，请不要调用 Connect 该方法。

另请参阅

适用于

Connect(String, Int32)

Source:: UDPClient.cs

Source:: UDPClient.cs

Source:: UDPClient.cs

Source:: UDPClient.cs

Source:: 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 = 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 获取特定错误代码。获取此代码后，可以参阅 Windows 套接字版本 2 API 错误代码文档，获取错误的详细说明。

注释

由于 UDP 协议是无连接的， Connect 因此该方法不会阻止。如果要接收多播数据报，请不要调用 Connect 该方法。

另请参阅

适用于

反馈

此页面是否有帮助？