UdpClient.Connect Metode

Referensi

Definisi

Ruang nama:: System.Net.Sockets

Rakitan:: System.Net.Sockets.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menetapkan host jarak jauh default.

Overload

Connect(IPEndPoint)	Menetapkan host jarak jauh default menggunakan titik akhir jaringan yang ditentukan.
Connect(IPAddress, Int32)	Menetapkan host jarak jauh default menggunakan alamat IP dan nomor port yang ditentukan.
Connect(String, Int32)	Menetapkan host jarak jauh default menggunakan nama host dan nomor port yang ditentukan.

Connect(IPEndPoint)

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Menetapkan host jarak jauh default menggunakan titik akhir jaringan yang ditentukan.

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)

Parameter

endPoint: IPEndPoint

Yang IPEndPoint menentukan titik akhir jaringan tempat Anda ingin mengirim data.

Pengecualian

SocketException

Terjadi kesalahan saat mengakses soket.

ArgumentNullException

endPointadalah null.

ObjectDisposedException

Sudah UdpClient ditutup.

Contoh

Contoh berikut menggunakan IPEndPoint untuk membuat host jarak jauh default.

//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

Keterangan

Metode menetapkan Connect host jarak jauh default menggunakan nilai yang ditentukan dalam endPoint parameter . Setelah ditetapkan, Anda tidak perlu menentukan host jarak jauh di setiap panggilan ke Send metode .

Membuat host jarak jauh default bersifat opsional. Menentukan host jarak jauh default membatasi Anda hanya untuk host tersebut. Jika Anda ingin mengirim datagram ke host jarak jauh yang berbeda, Anda harus melakukan panggilan lain ke Connect metode atau membuat yang lain UdpClient tanpa host jarak jauh default. Jika Anda telah menetapkan host jarak jauh default dan Anda juga menyediakan host jarak jauh dalam panggilan Anda ke Send metode , Send akan melempar SocketException. Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Jika Anda memanggil Connect metode , setiap datagram yang berasal dari alamat selain default yang ditentukan akan dibuang. Anda tidak dapat mengatur host jarak jauh default ke alamat siaran menggunakan metode ini kecuali Anda mewarisi dari UdpClient, gunakan metode Klien untuk mendapatkan yang mendasar Socket, dan atur opsi soket ke SocketOptionName.Broadcast.

Namun, Anda dapat menyiarkan data ke alamat siaran default, 255.255.255.255, jika Anda menentukan IPAddress.Broadcast dalam panggilan Anda ke Send metode . Jika aplikasi Anda memerlukan kontrol yang lebih besar atas alamat siaran, Anda juga dapat kembali menggunakan Socket kelas .

Catatan

Karena protokol UDP tidak terhubung, Connect metode tidak memblokir. Jangan panggil Connect metode jika Anda berniat menerima datagram multicasted.

Lihat juga

Berlaku untuk

Connect(IPAddress, Int32)

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Menetapkan host jarak jauh default menggunakan alamat IP dan nomor port yang ditentukan.

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)

Parameter

addr: IPAddress

IPAddress Dari host jarak jauh tempat Anda ingin mengirim data.

port: Int32

Nomor port tempat Anda ingin mengirim data.

Pengecualian

ObjectDisposedException

UdpClient ditutup.

ArgumentNullException

addradalah null.

ArgumentOutOfRangeException

port bukan antara MinPort dan MaxPort.

SocketException

Terjadi kesalahan saat mengakses soket.

Contoh

Contoh berikut menggunakan alamat IP dan nomor port untuk terhubung dengan host jarak jauh.

//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

Keterangan

Metode menetapkan Connect host jarak jauh default menggunakan nilai yang ditentukan dalam addr parameter dan port . Setelah ditetapkan, Anda tidak perlu menentukan host jarak jauh di setiap panggilan ke Send metode .

Jika Anda memanggil Connect metode , setiap datagram yang berasal dari alamat selain default yang ditentukan akan dibuang. Anda tidak dapat mengatur host jarak jauh default ke alamat siaran menggunakan metode ini kecuali Anda mewarisi dari UdpClient, gunakan metode klien untuk mendapatkan yang mendasar Socket, dan atur opsi soket ke SocketOptionName.Broadcast.

Catatan

Karena protokol UDP tidak terhubung, Connect metode tidak memblokir. Jangan panggil Connect metode jika Anda berniat menerima datagram multicasted.

Lihat juga

Berlaku untuk

Connect(String, Int32)

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Menetapkan host jarak jauh default menggunakan nama host dan nomor port yang ditentukan.

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)

Parameter

hostname: String

Nama DNS host jarak jauh tempat Anda ingin mengirim data.

port: Int32

Nomor port pada host jarak jauh tempat Anda ingin mengirim data.

Pengecualian

ObjectDisposedException

Sudah UdpClient ditutup.

ArgumentOutOfRangeException

port bukan antara MinPort dan MaxPort.

SocketException

Terjadi kesalahan saat mengakses soket.

Contoh

Contoh berikut menggunakan nama host dan nomor port untuk menyambungkan ke host jarak jauh.

//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

Keterangan

Metode menetapkan Connect host jarak jauh default menggunakan nilai yang ditentukan dalam port parameter dan hostname . Setelah ditetapkan, Anda tidak perlu menentukan host jarak jauh di setiap panggilan ke Send metode .

Jika Anda telah menetapkan host jarak jauh default dan Anda juga menyediakan host jarak jauh dalam panggilan Anda ke Send metode , Send akan melempar SocketException. Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Jika Anda memanggil Connect metode , setiap datagram yang berasal dari alamat selain default yang ditentukan akan dibuang. Anda tidak dapat mengatur host jarak jauh default ke alamat siaran menggunakan metode ini kecuali Anda mewarisi dari UdpClient, gunakan metode klien untuk mendapatkan yang mendasar Socket, dan atur opsi soket ke SocketOptionName.Broadcast.

Catatan

Karena protokol UDP tidak terhubung, Connect metode tidak memblokir. Jangan panggil Connect metode jika Anda berniat menerima datagram multicasted.

Lihat juga

Berlaku untuk

Bagikan melalui

UdpClient.Connect Metode

Definisi

Overload

Connect(IPEndPoint)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Connect(IPAddress, Int32)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Connect(String, Int32)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: