DatagramSocket.BindServiceNameAsync Metode

  • Referensi

Definisi

Ruang nama:
Windows.Networking.Sockets

Overload

BindServiceNameAsync(String)

Memulai operasi pengikatan pada DatagramSocket ke nama layanan lokal.
BindServiceNameAsync(String, NetworkAdapter)

Memulai operasi pengikatan pada DatagramSocket ke nama layanan lokal dan antarmuka jaringan tertentu.

BindServiceNameAsync(String)

Edit

Memulai operasi pengikatan pada DatagramSocket ke nama layanan lokal.

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

Parameter

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 BindServiceNameAsync mengikat ke alamat IP lokal semua antarmuka jaringan pada komputer lokal pada nama layanan lokal atau port UDP yang ditentukan dalam parameter localServiceName . Jika parameter localServiceName adalah string kosong, sistem akan memilih port UDP lokal untuk mengikat.

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

Pengikatan sangat penting untuk menerima data dari titik akhir jarak jauh 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. Menulis ke aliran yang dikembalikan oleh salah satu metode GetOutputStreamAsync juga akan menghasilkan operasi pengikatan jika soket belum terikat.

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.

Lihat juga

Berlaku untuk

BindServiceNameAsync(String, NetworkAdapter)

Edit

Memulai operasi pengikatan pada DatagramSocket ke nama layanan lokal dan antarmuka jaringan tertentu.

public:
 virtual IAsyncAction ^ BindServiceNameAsync(Platform::String ^ localServiceName, NetworkAdapter ^ adapter) = BindServiceNameAsync;
/// [Windows.Foundation.Metadata.Overload("BindServiceNameAndAdapterAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName, NetworkAdapter const& adapter);
[Windows.Foundation.Metadata.Overload("BindServiceNameAndAdapterAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName, NetworkAdapter adapter);
function bindServiceNameAsync(localServiceName, adapter)
Public Function BindServiceNameAsync (localServiceName As String, adapter As NetworkAdapter) As IAsyncAction

Parameter

localServiceName
String

Platform::String

winrt::hstring

Nama layanan lokal atau port UDP untuk mengikat objek DatagramSocket .

adapter
NetworkAdapter

Adaptor jaringan untuk mengikat objek DatagramSocket .

Mengembalikan

IAsyncAction

Operasi pengikatan asinkron pada objek DatagramSocket .

Atribut
OverloadAttribute RemoteAsyncAttribute

Keterangan

Metode [BindServiceNameAsync(String, NetworkAdapter) mengikat ke antarmuka jaringan yang ditentukan dalam parameter adaptor dan nama layanan lokal atau port UDP yang ditentukan dalam parameter localServiceName di komputer lokal. Jika parameter localServiceName adalah string kosong, sistem akan memilih port UDP lokal untuk mengikat. Jika parameter adapter null, kesalahan akan terjadi.

Mekanisme resolusi nama yang digunakan oleh metode [BindServiceNameAsync(String, NetworkAdapter) terbatas pada antarmuka yang ditentukan untuk namespace layanan sistem nama domain (DNS).

Kecuali Anda telah menggunakan properti DatagramSocketControl.MulticastOnly , metode BindServiceNameAsync akan gagal jika aplikasi lain yang menggunakan UDP ( DatagramSocket lain, misalnya) telah terikat ke port UDP lokal yang ditentukan dalam parameter localServiceName pada antarmuka jaringan yang sama.

Pengikatan sangat penting untuk menerima data dari titik akhir jarak jauh 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, tetapi tidak dapat dibatasi pada adaptor jaringan tertentu. Menulis ke aliran yang dikembalikan oleh salah satu metode GetOutputStreamAsync juga akan menghasilkan operasi pengikatan jika soket belum terikat, tetapi tidak dapat dibatasi pada adaptor jaringan tertentu.

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.

Jika metode [BindServiceNameAsync(String, NetworkAdapter) digunakan, operasi pengikatan akan membatasi paket multicast dan unicast masuk dan keluar ke adaptor yang ditentukan.

Menggunakan adaptor jaringan yang ditentukan adalah berdasarkan upaya terbaik. Di antara konfigurasi lainnya, sistem dengan adaptor yang dikonfigurasi dalam mode host lemah atau penerusan dapat menggunakan adaptor selain adaptor yang ditentukan.

Lihat juga

Berlaku untuk