UdpClient.Connect 方法

定义

命名空间:

System.Net.Sockets

程序集:

System.Net.Sockets.dll

建立默认远程主机。

重载

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

Connect(IPEndPoint)

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

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

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

备注

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

另请参阅

• Socket
• Send(Byte[], Int32, IPEndPoint)
• Receive(IPEndPoint)

Connect(IPAddress, Int32)

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 = 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使用 和 port 参数中指定的addr值建立默认远程主机。 建立后，无需在每次调用 Send 方法时指定远程主机。

建立默认远程主机是可选的。 指定默认远程主机仅限于该主机。 如果要将数据报发送到其他远程主机，则必须对 方法进行另一次调用 Connect ，或者创建另一个 UdpClient 没有默认远程主机的调用。 如果已建立默认远程主机，并且还在调用 Send 方法时提供远程主机， Send 将引发 SocketException。 如果收到 SocketException，请使用 SocketException.ErrorCode 获取特定的错误代码。 获取此代码后，可以参阅 Windows 套接字版本 2 API 错误代码 文档，获取错误的详细说明。

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

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

备注

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

另请参阅

• Socket
• Send(Byte[], Int32, IPEndPoint)
• Receive(IPEndPoint)

Connect(String, Int32)

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 = 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使用 和 hostname 参数中指定的port值建立默认远程主机。 建立后，无需在每次调用 Send 方法时指定远程主机。

建立默认远程主机是可选的。 指定默认远程主机仅限于该主机。 如果要将数据报发送到其他远程主机，则必须对 方法进行另一次调用 Connect ，或者创建另一个 UdpClient 没有默认远程主机的调用。

如果已建立默认远程主机，并且还在调用 Send 方法时提供远程主机， Send 将引发 SocketException。 如果收到 SocketException，请使用 SocketException.ErrorCode 获取特定的错误代码。 获取此代码后，可以参阅 Windows 套接字版本 2 API 错误代码 文档，获取错误的详细说明。

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

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

备注

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

另请参阅

• Socket
• Send(Byte[], Int32, IPEndPoint)
• Receive(IPEndPoint)