UdpAnySourceMulticastClient.BeginSendTo Methode

Definition

Achtung

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Startet den Vorgang, bei dem ein Unicastpaket an das angegebene Ziel gesendet wird.

public:
 IAsyncResult ^ BeginSendTo(cli::array <System::Byte> ^ buffer, int offset, int count, System::Net::IPEndPoint ^ remoteEndPoint, AsyncCallback ^ callback, System::Object ^ state);
[System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)]
public IAsyncResult BeginSendTo (byte[] buffer, int offset, int count, System.Net.IPEndPoint remoteEndPoint, AsyncCallback callback, object state);
[<System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)>]
member this.BeginSendTo : byte[] * int * int * System.Net.IPEndPoint * AsyncCallback * obj -> IAsyncResult
Public Function BeginSendTo (buffer As Byte(), offset As Integer, count As Integer, remoteEndPoint As IPEndPoint, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

buffer
Byte[]

Der Puffer, der die zu sendenden Daten enthält.

offset
Int32

Der Offset in Bytes ab dem Anfang vom buffer, aus dem die zu sendenden Daten gelesen werden sollen.

count
Int32

Die Anzahl von Bytes, die aus dem buffer gesendet werden sollen.

remoteEndPoint
IPEndPoint

Der Remoteendpunkt, an den das Paket gesendet werden soll.

callback
AsyncCallback

Die Rückrufmethode, die beim Abschließen des Vorgangs aufgerufen werden soll.

state
Object

Optionale Zustandsinformationen, die an die callback-Methode für diesen Vorgang übergeben werden sollen.

Gibt zurück

IAsyncResult

Ein IAsyncResult, das auf diesen Vorgang verweist.

Attribute

Ausnahmen

buffer ist ein NULL-Verweis (Nothing in Visual&#160;Basic).

offset ist kleiner als 0. - oder - offset ist größer als die Länge von buffer.

- oder - count ist kleiner als 0. - oder - offset plus die Anzahl ist größer als die Länge von buffer.

Die Multicastgruppe wurde noch nicht zusammengeführt.

Fehler beim Versuch, auf den Socket zuzugreifen.

Hinweise

Die BeginSendTo -Methode startet einen Vorgang zum Senden eines UDP-Pakets an die verbundene Multicastgruppe.

Der Client muss einen Join zur Multicastgruppe abgeschlossen haben. Die im -Parameter angegebene remoteEndPoint Zieladresse muss bereits ein Multicastpaket an diesen Empfänger gesendet haben. Einige Protokolle verwenden diese Informationen, um Die Flusssteuerung, Dienstqualitätsstatistiken oder Wiederherstellungsmeldungen zu übergeben.

Die im -Parameter angegebene callback Methode wird aufgerufen, wenn ein Paket empfangen wurde.

Die Übertragung ist nur zulässig, wenn die im -Parameter angegebene Adresse bereits remoteEndPoint ein Multicastpaket an diesen Empfänger gesendet hat. Wenn der Client keinen Zugriff hat, wird SocketException mit AccessDenied ausgelöst.

Wenn der im -Parameter angegebene Zielport remoteEndPoint kleiner als 1.024 ist, SocketException wird mit AccessDenied ausgelöst.

Es ist möglich, dass ein Socketfehler auftritt, wenn ein Empfangsvorgang synchron fehlschlägt, obwohl dies bei UDP ungewöhnlich ist. Wenn ein Socketfehler auftritt, wird SocketException eine ausgelöst. Der empfangene Fehler wird als Member der -Enumeration SocketError angegeben.

Gilt für