Socket.ReceiveFromAsync Methode

Definitie

Naamruimte:: System.Net.Sockets

Assembly's:: System.dll, System.Net.Sockets.dll

Assembly's:: netstandard.dll, System.Net.Sockets.dll

Assembly:: System.Net.Sockets.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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.

Overloads

Name	Description
ReceiveFromAsync(SocketAsyncEventArgs)	Begint asynchroon gegevens te ontvangen van een opgegeven netwerkapparaat.
ReceiveFromAsync(ArraySegment<Byte>, EndPoint)	Ontvangt gegevens en retourneert het eindpunt van de verzendende host.
ReceiveFromAsync(ArraySegment<Byte>, SocketFlags, EndPoint)	Ontvangt gegevens en retourneert het eindpunt van de verzendende host.
ReceiveFromAsync(Memory<Byte>, EndPoint, CancellationToken)	Ontvangt gegevens en retourneert het eindpunt van de verzendende host.
ReceiveFromAsync(Memory<Byte>, SocketFlags, EndPoint, CancellationToken)	Ontvangt gegevens en retourneert het eindpunt van de verzendende host.
ReceiveFromAsync(Memory<Byte>, SocketFlags, SocketAddress, CancellationToken)	Ontvangt een datagram in de gegevensbuffer, met behulp van het opgegeven SocketFlags, en slaat het eindpunt op.

ReceiveFromAsync(SocketAsyncEventArgs)

Bron:: Socket.cs

Bron:: Socket.cs

Bron:: Socket.cs

Bron:: Socket.cs

Bron:: Socket.cs

Begint asynchroon gegevens te ontvangen van een opgegeven netwerkapparaat.

public:
 bool ReceiveFromAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool ReceiveFromAsync(System.Net.Sockets.SocketAsyncEventArgs e);

member this.ReceiveFromAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function ReceiveFromAsync (e As SocketAsyncEventArgs) As Boolean

Parameters

e: SocketAsyncEventArgs

Het SocketAsyncEventArgs object dat moet worden gebruikt voor deze asynchrone socketbewerking.

Retouren

Boolean

true als de I/O-bewerking in behandeling is. De Completed gebeurtenis voor de e parameter wordt gegenereerd na voltooiing van de bewerking.

false als de I/O-bewerking synchroon is voltooid. In dit geval wordt de Completed gebeurtenis voor de e parameter niet gegenereerd en kan het e object dat als parameter wordt doorgegeven, direct worden onderzocht nadat de methodeaanroep terugkeert om het resultaat van de bewerking op te halen.

Uitzonderingen

ArgumentNullException

De RemoteEndPoint waarde kan niet null zijn.

InvalidOperationException

Er is al een socketbewerking uitgevoerd met behulp van het SocketAsyncEventArgs object dat is opgegeven in de e parameter.

ObjectDisposedException

De Socket is gesloten.

SocketException

Er is een fout opgetreden bij het openen van de socket.

Opmerkingen

De ReceiveFromAsync methode wordt voornamelijk gebruikt voor het ontvangen van gegevens op een verbindingsloze socket. Het lokale adres van de socket moet bekend zijn.

De beller moet de SocketAsyncEventArgs.RemoteEndPoint eigenschap instellen op een EndPoint van hetzelfde type als het eindpunt van de externe host. De eigenschap wordt bijgewerkt bij geslaagde ontvangst naar het werkelijke externe eindpunt.

De SocketAsyncEventArgs.SocketFlags eigenschap op de e parameter biedt de Window Sockets-serviceprovider aanvullende informatie over de leesaanvraag. Zie voor meer informatie over het gebruik van deze parameter System.Net.Sockets.SocketFlags.

De volgende eigenschappen en gebeurtenissen op het System.Net.Sockets.SocketAsyncEventArgs object zijn vereist om deze methode aan te roepen:

De aanroeper kan de SocketAsyncEventArgs.UserToken eigenschap instellen op een gewenst gebruikersstatusobject voordat de ReceiveFromAsync methode wordt aangeroepen, zodat de gegevens kunnen worden opgehaald in de callback-methode. Als de callback meer informatie nodig heeft dan één object, kan er een kleine klasse worden gemaakt om de andere vereiste statusgegevens als leden te bewaren.

Voor berichtgeoriënteerde sockets wordt een binnenkomend bericht in de buffer geplaatst tot de totale grootte van de buffer. De SocketAsyncEventArgs.Count en SocketAsyncEventArgs.Offset eigenschappen bepalen waar in de buffer de gegevens worden geplaatst en de hoeveelheid gegevens.

Voor bytestroomsockets worden binnenkomende gegevens in de buffer geplaatst totdat de buffer is gevuld, de verbinding wordt gesloten of de intern gebufferde gegevens uitgeput zijn. De SocketAsyncEventArgs.Count en SocketAsyncEventArgs.Offset eigenschappen bepalen waar in de buffer de gegevens worden geplaatst en de hoeveelheid gegevens.

Zie ook

Van toepassing op

ReceiveFromAsync(ArraySegment<Byte>, EndPoint)

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Ontvangt gegevens en retourneert het eindpunt van de verzendende host.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::SocketReceiveFromResult> ^ ReceiveFromAsync(ArraySegment<System::Byte> buffer, System::Net::EndPoint ^ remoteEndPoint);

public System.Threading.Tasks.Task<System.Net.Sockets.SocketReceiveFromResult> ReceiveFromAsync(ArraySegment<byte> buffer, System.Net.EndPoint remoteEndPoint);

member this.ReceiveFromAsync : ArraySegment<byte> * System.Net.EndPoint -> System.Threading.Tasks.Task<System.Net.Sockets.SocketReceiveFromResult>

Public Function ReceiveFromAsync (buffer As ArraySegment(Of Byte), remoteEndPoint As EndPoint) As Task(Of SocketReceiveFromResult)

Parameters

buffer: ArraySegment<Byte>

De buffer voor de ontvangen gegevens.

remoteEndPoint: EndPoint

Een eindpunt van hetzelfde type als het eindpunt van de externe host.

Retouren

Task<SocketReceiveFromResult>

Een asynchrone taak die is voltooid met een SocketReceiveFromResult met het aantal ontvangen bytes en het eindpunt van de verzendende host.

Uitzonderingen

ArgumentNullException

remoteEndPoint is null.

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

SecurityException

Een aanroeper in de aanroepstack beschikt niet over de vereiste machtigingen.

Van toepassing op

ReceiveFromAsync(ArraySegment<Byte>, SocketFlags, EndPoint)

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Ontvangt gegevens en retourneert het eindpunt van de verzendende host.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::SocketReceiveFromResult> ^ ReceiveFromAsync(ArraySegment<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEndPoint);

public System.Threading.Tasks.Task<System.Net.Sockets.SocketReceiveFromResult> ReceiveFromAsync(ArraySegment<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEndPoint);

member this.ReceiveFromAsync : ArraySegment<byte> * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> System.Threading.Tasks.Task<System.Net.Sockets.SocketReceiveFromResult>

Public Function ReceiveFromAsync (buffer As ArraySegment(Of Byte), socketFlags As SocketFlags, remoteEndPoint As EndPoint) As Task(Of SocketReceiveFromResult)

Parameters

buffer: ArraySegment<Byte>

De buffer voor de ontvangen gegevens.

socketFlags: SocketFlags

Een bitsgewijze combinatie van SocketFlags-waarden die worden gebruikt bij het ontvangen van de gegevens.

remoteEndPoint: EndPoint

Een eindpunt van hetzelfde type als het eindpunt van de externe host.

Retouren

Task<SocketReceiveFromResult>

Een asynchrone taak die is voltooid met een SocketReceiveFromResult met het aantal ontvangen bytes en het eindpunt van de verzendende host.

Uitzonderingen

ArgumentNullException

remoteEndPoint is null.

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

SecurityException

Een aanroeper in de aanroepstack beschikt niet over de vereiste machtigingen.

Van toepassing op

ReceiveFromAsync(Memory<Byte>, EndPoint, CancellationToken)

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Ontvangt gegevens en retourneert het eindpunt van de verzendende host.

public System.Threading.Tasks.ValueTask<System.Net.Sockets.SocketReceiveFromResult> ReceiveFromAsync(Memory<byte> buffer, System.Net.EndPoint remoteEndPoint, System.Threading.CancellationToken cancellationToken = default);

member this.ReceiveFromAsync : Memory<byte> * System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.SocketReceiveFromResult>

Public Function ReceiveFromAsync (buffer As Memory(Of Byte), remoteEndPoint As EndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of SocketReceiveFromResult)

Parameters

buffer: Memory<Byte>

De buffer voor de ontvangen gegevens.

remoteEndPoint: EndPoint

Een eindpunt van hetzelfde type als het eindpunt van de externe host.

cancellationToken: CancellationToken

Een annuleringstoken dat kan worden gebruikt om de asynchrone bewerking te signaleren, moet worden geannuleerd.

Retouren

ValueTask<SocketReceiveFromResult>

Een asynchrone taak die is voltooid met een SocketReceiveFromResult met het aantal ontvangen bytes en het eindpunt van de verzendende host.

Uitzonderingen

ArgumentNullException

remoteEndPoint is null.

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

SecurityException

Een aanroeper in de aanroepstack beschikt niet over de vereiste machtigingen.

OperationCanceledException

Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.

Van toepassing op

ReceiveFromAsync(Memory<Byte>, SocketFlags, EndPoint, CancellationToken)

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Ontvangt gegevens en retourneert het eindpunt van de verzendende host.

public System.Threading.Tasks.ValueTask<System.Net.Sockets.SocketReceiveFromResult> ReceiveFromAsync(Memory<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEndPoint, System.Threading.CancellationToken cancellationToken = default);

member this.ReceiveFromAsync : Memory<byte> * System.Net.Sockets.SocketFlags * System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.SocketReceiveFromResult>

Public Function ReceiveFromAsync (buffer As Memory(Of Byte), socketFlags As SocketFlags, remoteEndPoint As EndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of SocketReceiveFromResult)

Parameters

buffer: Memory<Byte>

De buffer voor de ontvangen gegevens.

socketFlags: SocketFlags

Een bitsgewijze combinatie van SocketFlags-waarden die worden gebruikt bij het ontvangen van de gegevens.

remoteEndPoint: EndPoint

Een eindpunt van hetzelfde type als het eindpunt van de externe host.

cancellationToken: CancellationToken

Een annuleringstoken dat kan worden gebruikt om de asynchrone bewerking te signaleren, moet worden geannuleerd.

Retouren

ValueTask<SocketReceiveFromResult>

Een asynchrone taak die is voltooid met een SocketReceiveFromResult met het aantal ontvangen bytes en het eindpunt van de verzendende host.

Uitzonderingen

ArgumentNullException

remoteEndPoint is null.

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

SecurityException

Een aanroeper in de aanroepstack beschikt niet over de vereiste machtigingen.

OperationCanceledException

Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.

Van toepassing op

ReceiveFromAsync(Memory<Byte>, SocketFlags, SocketAddress, CancellationToken)

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Bron:: Socket.Tasks.cs

Ontvangt een datagram in de gegevensbuffer, met behulp van het opgegeven SocketFlags, en slaat het eindpunt op.

public System.Threading.Tasks.ValueTask<int> ReceiveFromAsync(Memory<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.SocketAddress receivedAddress, System.Threading.CancellationToken cancellationToken = default);

member this.ReceiveFromAsync : Memory<byte> * System.Net.Sockets.SocketFlags * System.Net.SocketAddress * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function ReceiveFromAsync (buffer As Memory(Of Byte), socketFlags As SocketFlags, receivedAddress As SocketAddress, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parameters

buffer: Memory<Byte>

De buffer voor de ontvangen gegevens.

socketFlags: SocketFlags

Een bitsgewijze combinatie van de SocketFlags waarden die worden gebruikt bij het ontvangen van de gegevens.

receivedAddress: SocketAddress

Een SocketAddress exemplaar dat wordt bijgewerkt met de waarde van de externe peer wanneer deze methode wordt geretourneerd.

cancellationToken: CancellationToken

Een annuleringstoken dat kan worden gebruikt om de asynchrone bewerking te signaleren, moet worden geannuleerd.

Retouren

ValueTask<Int32>

Een asynchrone taak die is voltooid met een SocketReceiveFromResult met het aantal ontvangen bytes en het eindpunt van de verzendende host.

Uitzonderingen

ArgumentNullException

receivedAddress is null.

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

OperationCanceledException

Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.

Van toepassing op

Feedback

Is deze pagina nuttig?