Socket.BeginSendTo Metoda

public:
 IAsyncResult ^ BeginSendTo(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginSendTo (byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP, AsyncCallback? callback, object? state);

public IAsyncResult BeginSendTo (byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP, AsyncCallback callback, object state);

member this.BeginSendTo : byte[] * int * int * System.Net.Sockets.SocketFlags * System.Net.EndPoint * AsyncCallback * obj -> IAsyncResult

Public Function BeginSendTo (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, remoteEP As EndPoint, callback As AsyncCallback, state As Object) As IAsyncResult

Parametry

Návraty

Odkazuje IAsyncResult na asynchronní odesílání.

Výjimky

Poznámky

Zpětné volání, které se implementuje AsyncCallback do BeginSendTo , můžete předat, abyste dostali oznámení o dokončení operace. Všimněte si, že pokud podkladová síťová sada dokončí operaci synchronně, provede se zpětné volání vložené během volání .BeginSendTo V tomto případě CompletedSynchronously bude vlastnost vrácena IAsyncResult nastavena na , true aby bylo možné označit, že metoda byla dokončena synchronně. AsyncState K získání objektu stavu předaného BeginSendTo metodě použijte vlastnost IAsyncResult .

Operace BeginSendTo musí být dokončena voláním EndSendTo metody . Metoda je obvykle vyvolána poskytnutým AsyncCallback delegátem. EndSendTo až do dokončení operace zablokuje volající vlákno.

Pokud používáte protokol orientovaný na připojení, musíte nejprve volat metodu , , Accept, nebo BeginAccept nebo vyvolá metodu SocketException.BeginSendToBeginConnectConnect BeginSendTobude parametr ignorovat remoteEP a odesílat data do ConnectEndPoint metody , BeginConnect, Accept, nebo BeginAccept .

Pokud používáte protokol bez připojení, nemusíte před voláním SendTovytvořit výchozího vzdáleného Connect hostitele pomocí metody nebo BeginConnect . Stačí to provést pouze v případě, že máte v úmyslu volat metodu BeginSend . Pokud zavoláte metodu Connect nebo BeginConnect před voláním SendTometody , remoteEP parametr přepíše zadaného výchozího vzdáleného hostitele pouze pro danou operaci odeslání. Také nemusíte volat metodu Bind . V takovém případě podkladový poskytovatel služeb přiřadí nejvhodnější místní síťovou adresu a číslo portu. Pokud chcete, aby podkladový poskytovatel služeb vybral bezplatný port, použijte číslo portu nula. Pokud potřebujete identifikovat přiřazenou adresu místní sítě a číslo portu, můžete po EndSendTo úspěšném dokončení metody použít LocalEndPoint vlastnost .

Pokud chcete odesílat data na adresu všesměrového vysílání, musíte nejprve zavolat metodu SetSocketOption a nastavit možnost soketu na SocketOptionName.Broadcast. –Musíte také zajistit, aby velikost vyrovnávací paměti nepřekračovala maximální velikost paketů příslušného poskytovatele služeb. Pokud ano, datagram se neodesílají a EndSendTo vyvolá .SocketException

Pokud jako socketflags parametr zadáte DontRoute příznak, nebudou odesílaná data směrována.

Platí pro

Viz také

• EndSendTo(IAsyncResult)
• AsyncCallback
• Connect(EndPoint)
• LocalEndPoint
• Broadcast
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• Zařazování delegáta jako metody zpětného volání