Socket.ReceiveMessageFrom Méthode

Source:

Socket.cs

Source:

Socket.cs

Source:

Socket.cs

public:
 int ReceiveMessageFrom(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags % socketFlags, System::Net::EndPoint ^ % remoteEP, [Runtime::InteropServices::Out] System::Net::Sockets::IPPacketInformation % ipPacketInformation);

public int ReceiveMessageFrom (byte[] buffer, int offset, int size, ref System.Net.Sockets.SocketFlags socketFlags, ref System.Net.EndPoint remoteEP, out System.Net.Sockets.IPPacketInformation ipPacketInformation);

member this.ReceiveMessageFrom : byte[] * int * int * SocketFlags * EndPoint * IPPacketInformation -> int

Public Function ReceiveMessageFrom (buffer As Byte(), offset As Integer, size As Integer, ByRef socketFlags As SocketFlags, ByRef remoteEP As EndPoint, ByRef ipPacketInformation As IPPacketInformation) As Integer

Paramètres

Retours

Nombre d’octets reçus.

Exceptions

Remarques

La ReceiveMessageFrom méthode lit les données dans le buffer paramètre, retourne le nombre d’octets correctement lus et capture le point de terminaison de l’hôte distant à partir duquel les données ont été envoyées, ainsi que des informations sur le paquet reçu.

La ReceiveMessageFrom méthode est principalement utilisée pour recevoir des données de message sur un socket sans connexion. L’adresse locale du socket doit être connue. Cette méthode ne peut être utilisée qu’avec des datagrammes et des sockets bruts. Le socket doit être initialisé avec le type de socket défini sur Dgram ou Raw avant d’appeler cette méthode. Cette opération peut être effectuée lorsque le socket est construit à l’aide de Socket.

Pour les sockets orientés messages, un message entrant est placé dans le buffer paramètre jusqu’à la taille totale spécifiée dans le size paramètre . Le offset paramètre détermine où les buffer données sont placées. La quantité réelle de données placées dans est buffer retournée par la ReceiveMessageFrom méthode .

La ReceiveMessageFrom méthode définit automatiquement l’option PacketInformation socket sur true la première fois qu’elle est appelée pour un donné Socket. Toutefois, l’objet retourné IPPacketInformation n’est valide que pour les paquets qui arrivent sur l’ordinateur local une fois l’option de socket définie. Si un socket est envoyé des paquets entre le moment où il est lié à un point de terminaison local (explicitement par la Bind méthode ou implicitement par l’une Connectdes méthodes , ConnectAsync, SendToouSendToAsync) et son premier appel à la méthode, les appels à ReceiveMessageFrom la ReceiveMessageFrom méthode retournent des objets non valides IPPacketInformation pour ces paquets.

Pour s’assurer que tous les IPPacketInformation objets sont valides, une application doit définir l’option PacketInformation de socket sur true avant d’être liée à un point de terminaison local à l’aide de la SetSocketOption(SocketOptionLevel, SocketOptionName, Boolean) méthode .

Une application peut examiner le ipPacketInformation paramètre si elle doit savoir si le datagramme a été envoyé à l’aide d’une adresse de monodiffusion, de multidiffusion ou de diffusion.

Voir aussi

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Source:

Socket.cs

Source:

Socket.cs

Source:

Socket.cs

public:
 int ReceiveMessageFrom(Span<System::Byte> buffer, System::Net::Sockets::SocketFlags % socketFlags, System::Net::EndPoint ^ % remoteEP, [Runtime::InteropServices::Out] System::Net::Sockets::IPPacketInformation % ipPacketInformation);

public int ReceiveMessageFrom (Span<byte> buffer, ref System.Net.Sockets.SocketFlags socketFlags, ref System.Net.EndPoint remoteEP, out System.Net.Sockets.IPPacketInformation ipPacketInformation);

member this.ReceiveMessageFrom : Span<byte> * SocketFlags * EndPoint * IPPacketInformation -> int

Public Function ReceiveMessageFrom (buffer As Span(Of Byte), ByRef socketFlags As SocketFlags, ByRef remoteEP As EndPoint, ByRef ipPacketInformation As IPPacketInformation) As Integer

Paramètres

Retours

Nombre d’octets reçus.

Exceptions