UdpAnySourceMulticastClient.BeginSendTo Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Let op
This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.
Hiermee begint u de bewerking van het verzenden van een unicastpakket naar de opgegeven bestemming.
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 -> IAsyncResultPublic Function BeginSendTo (buffer As Byte(), offset As Integer, count As Integer, remoteEndPoint As IPEndPoint, callback As AsyncCallback, state As Object) As IAsyncResultParameters
- buffer
- Byte[]
De buffer die de gegevens bevat die moeten worden verzonden.
- offset
- Int32
De offset, in bytes, vanaf het begin van de buffer gegevens die moeten worden verzonden, lezen.
- count
- Int32
Het aantal bytes dat moet worden verzonden vanaf de buffer.
- remoteEndPoint
- IPEndPoint
Het externe eindpunt waarnaar het pakket moet worden verzonden.
- callback
- AsyncCallback
De callback-methode die moet worden aangeroepen wanneer de bewerking is voltooid.
- state
- Object
Optionele statusinformatie die moet worden doorgegeven aan de callback methode voor deze bewerking.
Retouren
Een IAsyncResult die verwijst naar deze bewerking.
- Kenmerken
Uitzonderingen
buffer is een null-verwijzing (niets in Visual Basic).
offset is kleiner dan 0
– of –
offset is groter dan de lengte van de buffer.
– of –
count is kleiner dan 0
– of –
offset plus het aantal is groter dan de lengte van de buffer.
De multicast-groep is nog niet toegevoegd.
De UdpAnySourceMulticastClient is verwijderd.
Er is een fout opgetreden bij het openen van de socket.
Opmerkingen
De BeginSendTo methode begint met het verzenden van een UDP-pakket naar de gekoppelde multicast-groep.
De client moet een join hebben voltooid voor de multicast-groep. Het doeladres dat in de remoteEndPoint parameter is opgegeven, moet al een multicastpakket naar deze ontvanger hebben verzonden. Sommige protocollen gebruiken deze informatie om stroombeheer, kwaliteit van servicestatistieken of herstelberichten door te geven.
De methode die in de callback parameter is opgegeven, wordt aangeroepen wanneer een pakket is ontvangen.
De overdracht is alleen toegestaan als het adres dat is opgegeven in de remoteEndPoint parameter al een multicast-pakket naar deze ontvanger heeft verzonden. Als de client geen toegang heeft, wordt er een SocketException gegenereerd met AccessDenied.
Als de doelpoort die is opgegeven in de remoteEndPoint parameter kleiner is dan 1024, wordt er een SocketException gegenereerd met AccessDenied.
Het is mogelijk om een socketfout te hebben als een ontvangstbewerking synchroon mislukt, hoewel dit ongebruikelijk is met UDP. Als er een socketfout optreedt, wordt er een SocketException gegenereerd. De ontvangen fout wordt opgegeven als lid van de SocketError opsomming.