UdpSingleSourceMulticastClient.BeginSendToSource Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.dll

Przestroga

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

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

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 elementu , aby odczytać dane do wysłania.

count

Int32

Liczba bajtów do wysłania z obiektu buffer.

remotePort

Int32

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

callback

AsyncCallback

Metoda wywołania zwrotnego, która ma być wywoływana po zakończeniu operacji.

state

Object

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

Zwraca

IAsyncResult

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

Atrybuty

ObsoleteAttribute

Wyjątki

ArgumentNullException

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

ArgumentOutOfRangeException

offset jest mniejsza niż 0

-lub-

offset jest większa niż długość obiektu buffer.

-lub-

count jest mniejsza niż 0

-lub-

offsetplus 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 dołączona.

ObjectDisposedException

Element UdpSingleSourceMulticastClient został usunięty.

SocketException

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

Uwagi

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

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

Metoda określona w parametrze callback jest wywoływana po wysłaniu pakietu.

Klient musi mieć ukończone sprzężenie do grupy multiemisji.

Jeśli port docelowy określony w parametrze remotePort jest mniejszy niż 1024, SocketException parametr jest zgłaszany za pomocą polecenia AccessDenied.

Istnieje możliwość wystąpienia błędu gniazda, jeśli operacja wysyłania nie powiedzie się synchronicznie, chociaż jest to rzadkością w przypadku protokołu UDP. W przypadku wystąpienia błędu SocketException gniazda zgłaszany jest błąd . Odebrany błąd jest określony jako element członkowski SocketError wyliczenia.