UdpSingleSourceMulticastClient.BeginSendToSource Methode

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.dll

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 die zuvor angegebene Quelle gesendet wird.

public:
 IAsyncResult ^ BeginSendToSource(cli::array <System::Byte> ^ buffer, int offset, int count, int remotePort, 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 BeginSendToSource (byte[] buffer, int offset, int count, int remotePort, 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.BeginSendToSource : byte[] * int * int * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginSendToSource (buffer As Byte(), offset As Integer, count As Integer, remotePort As Integer, 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.

remotePort

Int32

Der Remoteport, an den das Paket gesendet werden soll. Die Remoteadresse wird durch den UdpSingleSourceMulticastClient(IPAddress, IPAddress, Int32)-Konstruktor angegeben.

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

ObsoleteAttribute

Ausnahmen

ArgumentNullException

buffer ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentOutOfRangeException

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.

- oder -

remotePort ist kleiner als 0 oder größer als 65.535.

InvalidOperationException

Die Multicastgruppe wurde noch nicht zusammengeführt.

ObjectDisposedException

UdpSingleSourceMulticastClient wurde verworfen.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

Hinweise

Die BeginSendToSource -Methode beginnt mit einem Vorgang zum Senden eines UDP-Pakets an die zuvor angegebene Quelle.

Einige Protokolle verwenden diese Informationen, um Flusssteuerung, Dienstqualitätsstatistiken oder Wiederherstellungsmeldungen zu übergeben.

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

Der Client muss eine Verknüpfung mit der Multicastgruppe abgeschlossen haben.

Wenn der im remotePort Parameter angegebene Zielport kleiner als 1.024 ist, wird mit SocketExceptionAccessDeniedausgelöst.

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