UdpSingleSourceMulticastClient.BeginReceiveFromSource 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 das Empfangen eines Pakets von einer verknüpften Multicastgruppe und ruft den angegebenen Rückruf auf, wenn ein Paket von einem bestimmten Absender in der Gruppe angekommen ist.

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

Public Function BeginReceiveFromSource (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

buffer

Byte[]

Der Puffer zum Speichern der empfangenen Daten.

offset

Int32

Der Offset, in Bytes, ab dem Anfang des buffers, in dem die Daten gespeichert werden sollen.

count

Int32

Die maximale Anzahl der zu empfangenden und im buffer zu speichernden Bytes.

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.

InvalidOperationException

Die Multicastgruppe wurde noch nicht zusammengeführt.

ObjectDisposedException

UdpSingleSourceMulticastClient wurde verworfen.

SocketException

Fehler beim Versuch, auf den Socket zum Empfangen zuzugreifen.

Hinweise

Die BeginReceiveFromSource -Methode beginnt einen Vorgang zum Empfangen eines UDP-Pakets von der eingebundenen Multicastgruppe von einem einzelnen Absender. Der lokale Port, die Multicastgruppe und die Absenderquelladresse werden im UdpSingleSourceMulticastClient Konstruktor angegeben. Der Multicastclient muss auch eine Verknüpfung mit der Multicastgruppe abgeschlossen haben.

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

Es ist möglich, einen Socketfehler zu haben, wenn ein Empfangsvorgang 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.