DatagramSocket.BindEndpointAsync(HostName, String) Metode

  • Referensi

Definisi

Ruang nama:
Windows.Networking.Sockets
Edit

Memulai operasi pengikatan pada DatagramSocket ke nama host lokal dan nama layanan lokal.

public:
 virtual IAsyncAction ^ BindEndpointAsync(HostName ^ localHostName, Platform::String ^ localServiceName) = BindEndpointAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindEndpointAsync(HostName const& localHostName, winrt::hstring const& localServiceName);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindEndpointAsync(HostName localHostName, string localServiceName);
function bindEndpointAsync(localHostName, localServiceName)
Public Function BindEndpointAsync (localHostName As HostName, localServiceName As String) As IAsyncAction

Parameter

localHostName
HostName

Nama host lokal atau alamat IP untuk mengikat objek DatagramSocket .

localServiceName
String

Platform::String

winrt::hstring

Nama layanan lokal atau port UDP untuk mengikat objek DatagramSocket .

Mengembalikan

IAsyncAction

Operasi pengikatan asinkron pada objek DatagramSocket .

Atribut
RemoteAsyncAttribute

Persyaratan Windows

Kemampuan aplikasi
ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Keterangan

Metode BindEndpointAsync mengikat DatagramSocket ke nama host lokal atau alamat IP yang ditentukan dalam parameter localHostName dan nama layanan lokal atau alamat nomor port UDP yang ditentukan dalam parameter localServiceName . Jika parameter localHostName null, sistem akan memilih alamat IP lokal untuk mengikat. Jika parameter localServiceName adalah string kosong, sistem akan memilih port UDP lokal untuk mengikat.

Kecuali Anda telah menggunakan properti DatagramSocketControl.MulticastOnly , metode BindEndpointAsync akan gagal jika aplikasi lain yang menggunakan UDP (misalnya, DatagramSocket lain) telah terikat ke alamat IP lokal dan port UDP yang ditentukan dalam parameter localHostName dan localServiceName .

Pengikatan sangat penting untuk menerima data dari titik akhir jarak jauh apa pun pada DatagramSocket, dan biasanya dilakukan setelah soket dibuat dan peristiwa MessageReceived telah diatur. Metode BindServiceNameAsync atau BindEndpointAsync digunakan untuk mengikat DatagramSocket ke nama layanan lokal atau port UDP. Metode ConnectAsync juga akan menghasilkan operasi pengikatan jika soket belum terikat. Menulis ke aliran yang dikembalikan oleh salah satu metode GetOutputStreamAsync juga akan menghasilkan operasi pengikatan.

Metode BindServiceNameAsync dan BindEndpointAsync tidak diperlukan dalam kasus berikut:

  • DatagramSocket hanya digunakan untuk mengirim data.
  • DatagramSocket digunakan untuk mengirim data ke dan menerima data dari satu titik akhir.

Berlaku untuk

Lihat juga