DatagramSocket.BindEndpointAsync(HostName, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Startet einen Bindungsvorgang für ein DatagramSocket auf einen lokalen Hostnamen und einen lokalen Dienstnamen.
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 IAsyncActionParameter
- localHostName
- HostName
Der lokale Hostname oder die IP-Adresse, an die das DatagramSocket-Objekt gebunden werden soll.
- localServiceName
-
String
Platform::String
winrt::hstring
Der Name des lokalen Diensts oder der UDP-Port, an den das DatagramSocket-Objekt gebunden werden soll.
Gibt zurück
Ein asynchroner Bindungsvorgang für ein DatagramSocket-Objekt .
- Attribute
Windows-Anforderungen
| Anforderungen | Beschreibung |
|---|---|
| App-Funktionen |
internetClientServer
privateNetworkClientServer
|
Hinweise
Die BindEndpointAsync-Methode bindet das DatagramSocket an den lokalen Hostnamen oder die ip-Adresse, die im parameter "localHostName " angegeben ist, und die lokale Dienstname- oder UDP-Portnummeradresse, die im parameter "localServiceName " angegeben ist. Wenn der parameter localHostName null ist, wählt das System die lokale IP-Adresse aus, an die eine Bindung erfolgen soll. Wenn der parameter localServiceName eine leere Zeichenfolge ist, wählt das System den lokalen UDP-Port aus, an den eine Bindung erfolgen soll.
Sofern Sie die DatagramSocketControl.MulticastOnly-Eigenschaft nicht verwendet haben, schlägt die BindEndpointAsync-Methode fehl, wenn eine andere App, die UDP verwendet (z. B. ein anderes DatagramSocket), bereits an die lokale IP-Adresse und den UDP-Port gebunden wurde, der in den parametern localHostName und localServiceName angegeben ist.
Die Bindung ist für den Empfang von Daten von jedem Remoteendpunkt auf einem DatagramSocket unerlässlich und wird häufig durchgeführt, nachdem ein Socket erstellt wurde und das MessageReceived-Ereignis festgelegt wurde. Die BindServiceNameAsync - oder BindEndpointAsync-Methode wird verwendet, um ein DatagramSocket an einen lokalen Dienstnamen oder UDP-Port zu binden. Die ConnectAsync-Methoden führen auch zu einem Bindungsvorgang, wenn der Socket noch nicht gebunden ist. Das Schreiben in einen von einer der GetOutputStreamAsync-Methoden zurückgegebenen Datenstrom führt ebenfalls zu einem Bindungsvorgang.
Die Methoden BindServiceNameAsync und BindEndpointAsync sind in den folgenden Fällen nicht erforderlich:
- Das DatagramSocket wird nur zum Senden von Daten verwendet.
- Das DatagramSocket wird verwendet, um Daten an einen einzelnen Endpunkt zu senden und von diesen zu empfangen.