UdpSingleSourceMulticastClient.BeginSendToSource Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net.Sockets

Zestaw:: System.Net.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przestroga

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

Rozpoczyna operację wysłania pakietu emisji pojedynczej do źródła określonego wcześniej.

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

Parametry

buffer: Byte[]

Bufor zawierający dane do wysłania.

offset: Int32

Przesunięcie, w bajtach, od początku buffer do odczytu danych do wysłania.

count: Int32

Liczba bajtów do wysłania z buffer .

remotePort: Int32

Port zdalny, do którego ma zostać wysłany pakiet. Adres zdalny jest określany przez UdpSingleSourceMulticastClient(IPAddress, IPAddress, Int32) konstruktora.

callback: AsyncCallback

Metoda wywołania zwrotnego do wywołania po zakończeniu operacji.

state: Object

Opcjonalne informacje o stanie przekazane do callback metody dla tej operacji.

Zwraca

IAsyncResult

IAsyncResult, Który odwołuje się do tej operacji.

Atrybuty: ObsoleteAttribute

Wyjątki

ArgumentNullException

buffer jest odwołaniem o wartości null (Nothing w Visual Basic).

ArgumentOutOfRangeException

offset jest mniejsze niż 0 -lub- offset jest większa niż długość buffer .

-lub- count jest mniejsze niż 0 -lub- offset a liczba jest większa niż długość buffer .

-lub- remotePort jest mniejsza niż 0 lub większa niż 65 535.

InvalidOperationException

Grupa multiemisji nie została jeszcze przyłączona.

ObjectDisposedException

Został UdpSingleSourceMulticastClient usunięty.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

Uwagi

BeginSendToSourceMetoda rozpoczyna operację wysyłania pakietu UDP do wcześniej określonego źródła.

Niektóre protokoły używają tych informacji do przekazywania sterowania przepływem, statystyk jakości usług lub komunikatów odzyskiwania.

Metoda określona w callback parametrze jest wywoływana, gdy pakiet został wysłany.

Klient musi zakończyć dołączanie do grupy multiemisji.

Jeśli port docelowy określony w remotePort parametrze jest mniejszy niż 1 024, SocketException zostanie zgłoszony przy użyciu AccessDenied .

Jeśli operacja wysyłania nie powiedzie się synchronicznie, może występować awaria gniazda, chociaż jest to nietypowe w przypadku protokołu UDP. Jeśli wystąpi awaria gniazda, SocketException jest zgłaszany. Otrzymany błąd jest określony jako element członkowski SocketError wyliczenia.

Dotyczy