UdpAnySourceMulticastClient.BeginSendTo Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.dll

Upozornění

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

Zahájí operaci odeslání paketu jednosměrového vysílání do zadaného cíle.

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

Parametry

buffer

Byte[]

Vyrovnávací paměť, která obsahuje data k odeslání.

offset

Int32

Posun (v bajtech) od začátku buffer operace pro čtení odesílaných dat.

count

Int32

Počet bajtů, které se mají odeslat z buffer.

remoteEndPoint

IPEndPoint

Vzdálený koncový bod, do kterého má být paket odeslán.

callback

AsyncCallback

Metoda zpětného volání, která se má vyvolat po dokončení operace.

state

Object

Volitelné informace o stavu, které se callback mají předat metodě pro tuto operaci.

Návraty

IAsyncResult

Objekt IAsyncResult , který odkazuje na tuto operaci.

Atributy

ObsoleteAttribute

Výjimky

ArgumentNullException

buffer je odkaz s hodnotou null (v jazyce Visual Basic není nic).

ArgumentOutOfRangeException

offset je menší než 0

-nebo-

offset je větší než délka buffer.

-nebo-

count je menší než 0

-nebo-

offset plus počet je větší než délka buffer.

InvalidOperationException

Skupina vícesměrového vysílání ještě nebyla připojena.

ObjectDisposedException

Byla UdpAnySourceMulticastClient odstraněna.

SocketException

Při pokusu o přístup k soketu došlo k chybě.

Poznámky

Metoda BeginSendTo zahájí operaci odeslání paketu UDP do připojené skupiny vícesměrového vysílání.

Klient musí mít dokončené připojení ke skupině vícesměrového vysílání. Cílová adresa zadaná v parametru remoteEndPoint již musí tomuto příjemci odeslat paket vícesměrového vysílání. Některé protokoly používají tyto informace k předávání řízení toku, statistiky kvality služby nebo zpráv o obnovení.

Metoda zadaná v parametru callback je vyvolána při přijetí paketu.

Přenos je povolen pouze v případě, že adresa zadaná v parametru remoteEndPoint již odeslala paket vícesměrového vysílání tomuto příjemci. Pokud klient nemá povolený přístup, vyvolá se SocketException příkaz .AccessDenied

Pokud je cílový port zadaný v parametru remoteEndPoint menší než 1 024, SocketException vyvolá se parametr .AccessDenied

Pokud operace příjmu selže synchronně, může dojít k selhání soketu, i když je to u protokolu UDP neobvyklé. Pokud dojde k selhání soketu, vyvolá se SocketException chyba . Přijatá chyba je určena jako člen výčtu SocketError .