共用方式為


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,指定您想傳送資料所至的網路端點。

例外狀況

存取通訊端時發生錯誤。

endPointnull

範例

下列範例會使用 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 Sockets 第 2 版 API 錯誤碼 檔,以取得錯誤的詳細描述。

如果您呼叫 Connect 方法,任何從指定預設值以外的位址抵達的數據報都會被捨棄。 除非您繼承自 UdpClient,否則您無法使用此方法將預設遠端主機設定為廣播位址,請使用 Client 方法來取得基礎 Socket,並將套接字選項設定為 SocketOptionName.Broadcast

不過,如果您在方法的呼叫Send中指定IPAddress.Broadcast,您可以將數據廣播至默認廣播位址 255.255.255.255。 如果您的應用程式需要更充分地控制廣播位址,您也可以還原為使用 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

您想傳送資料所至的通訊埠編號。

例外狀況

addrnull

port 不在 MinPortMaxPort 之間。

存取通訊端時發生錯誤。

範例

下列範例會使用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 Sockets 第 2 版 API 錯誤碼 檔,以取得錯誤的詳細描述。

如果您呼叫 Connect 方法,任何從指定預設值以外的位址抵達的數據報都會被捨棄。 您無法使用此方法會預設遠端主機設定為廣播位址,除非您繼承自 UdpClient,否則請使用用戶端方法來取得基礎 Socket,並將套接字選項設定為 SocketOptionName.Broadcast

不過,如果您在方法的呼叫Send中指定IPAddress.Broadcast,您可以將數據廣播至默認廣播位址 255.255.255.255。 如果您的應用程式需要更充分地控制廣播位址,您也可以還原為使用 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

您想傳送資料所至的遠端主機的通訊埠編號。

例外狀況

port 不在 MinPortMaxPort 之間。

存取通訊端時發生錯誤。

範例

下列範例會使用主機名和埠號碼來連線到遠端主機。

//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 Sockets 第 2 版 API 錯誤碼 檔,以取得錯誤的詳細描述。

如果您呼叫 Connect 方法,任何從指定預設值以外的位址抵達的數據報都會被捨棄。 您無法使用此方法會預設遠端主機設定為廣播位址,除非您繼承自 UdpClient,否則請使用用戶端方法來取得基礎 Socket,並將套接字選項設定為 SocketOptionName.Broadcast

不過,如果您在方法的呼叫Send中指定IPAddress.Broadcast,您可以將數據廣播至默認廣播位址 255.255.255.255。 如果您的應用程式需要更充分地控制廣播位址,您也可以還原為使用 Socket 類別。

注意

因為 UDP 通訊協定是無連線的,所以 Connect 方法不會封鎖。 如果您想要接收多播數據報, Connect 請勿呼叫 方法。

另請參閱

適用於