Socket.BeginReceiveFrom Metod

public:
 IAsyncResult ^ BeginReceiveFrom(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 BeginReceiveFrom(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, ref System.Net.EndPoint remoteEP, AsyncCallback? callback, object? state);

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

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

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

Parametrar

Returer

En IAsyncResult som refererar till den asynkrona läsningen.

Undantag

Kommentarer

Du kan skicka ett återanrop som implementeras AsyncCallback till BeginReceiveFrom för att få ett meddelande om att åtgärden har slutförts. Observera att om den underliggande nätverksstacken slutför åtgärden synkront körs återanropet infogat under anropet till BeginReceiveFrom. I det här fallet CompletedSynchronously anges egenskapen för den returnerade IAsyncResult till för true att indikera att metoden slutfördes synkront. AsyncState Använd egenskapen för IAsyncResult att hämta tillståndsobjektet som skickas BeginReceiveFrom till metoden.

Den asynkrona BeginReceiveFrom åtgärden måste slutföras genom att anropa EndReceiveFrom metoden. Metoden anropas vanligtvis av ombudet AsyncCallback . EndReceiveFrom blockerar den anropande tråden tills åtgärden har slutförts.

Den här metoden läser in data i parametern buffer och avbildar fjärrvärdens slutpunkt från vilken data skickas. Information om hur du hämtar den här slutpunkten finns i EndReceiveFrom. Den här metoden är mest användbar om du tänker ta emot anslutningslösa datagram asynkront från en okänd värd eller flera värdar. I dessa fall BeginReceiveFrom läser du det första kodade datagrammet som tas emot i den lokala nätverksbufferten. Om datagrammet som du får är större än storleken på bufferBeginReceiveFrom fyller buffer metoden med så mycket av meddelandet som möjligt och genererar en SocketException. Om du använder ett opålitligt protokoll går överskottsdata förlorade. Om du använder ett tillförlitligt protokoll behålls överskottsdata av tjänstleverantören och du kan hämta dem genom att anropa BeginReceiveFrom metoden med en tillräckligt stor buffert.

För att garantera att fjärrvärdens slutpunkt alltid returneras bör ett program uttryckligen binda Socket till en lokal slutpunkt med hjälp av Bind metoden och sedan anropa SetSocketOption metoden med parametern optionLevel inställd på IP eller IPv6 efter behov, parametern optionName inställd på PacketInformationoch parametern optionValue för att aktivera det här alternativet innan metoden anropas BeginReceiveFrom . Annars är det möjligt att fjärrvärdens slutpunkt inte returneras när avsändaren har skickat ett antal datagram innan mottagaren har anropat BeginReceiveFrom metoden.

Även om BeginReceiveFrom det är avsett för anslutningslösa protokoll kan du även använda ett anslutningsorienterat protokoll. Om du väljer att göra det måste du först antingen upprätta en fjärrvärdanslutning genom att anropa Connect / BeginConnect metoden eller acceptera en inkommande anslutningsbegäran genom att anropa Accept metoden eller BeginAccept . Om du anropar BeginReceiveFrom metoden innan du upprättar eller accepterar en anslutning får du en SocketException. Du kan också upprätta en standardvärd för ett anslutningslöst protokoll innan du anropar BeginReceiveFrom metoden.

Parametern remoteEp

Med anslutningsorienterade socketar BeginReceiveFrom läser du så mycket data som är tillgängligt upp till det antal byte som anges av parametern size .

Om du vill avbryta en väntande BeginReceiveFromanropar du Close metoden.

Se även

• EndReceiveFrom(IAsyncResult, EndPoint)
• AsyncCallback
• Bind(EndPoint)
• Connect(EndPoint)
• Accept()
• Marshaling a Delegate as a Callback Method