UdpClient.Connect 方法

參考

定義

命名空間:: System.Net.Sockets

組件:: System.Net.Sockets.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

建立預設遠端主機。

多載

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 來取得特定的錯誤碼。取得此程式代碼之後，您可以參考 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

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

例外狀況

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，否則請使用用戶端方法來取得基礎 Socket，並將套接字選項設定為 SocketOptionName.Broadcast。

注意

因為 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

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

例外狀況

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

注意

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

另請參閱

適用於

共用方式為

UdpClient.Connect 方法

定義

多載

Connect(IPEndPoint)

參數

例外狀況

範例

備註

另請參閱

適用於

Connect(IPAddress, Int32)

參數

例外狀況

範例

備註

另請參閱

適用於

Connect(String, Int32)

參數

例外狀況

範例

備註

另請參閱

適用於

其他資源