SocketAddress Classe

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Primitives.dll

Source:

SocketAddress.cs

Stocke des informations sérialisées provenant des classes dérivées EndPoint.

public ref class SocketAddress : IEquatable<System::Net::SocketAddress ^>

public class SocketAddress : IEquatable<System.Net.SocketAddress>

type SocketAddress = class
    interface IEquatable<SocketAddress>

Public Class SocketAddress
Implements IEquatable(Of SocketAddress)

Héritage

Object

SocketAddress

Implémente

IEquatable<SocketAddress>

Exemples

L’exemple suivant montre comment utiliser SocketAddress pour sérialiser une instance de la EndPoint classe . Après la sérialisation, la mémoire tampon d’octet sous-jacente de contient SocketAddress toutes les informations d’état IPEndPoint .

//Creates an IpEndPoint.
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );

//Serializes the IPEndPoint.
SocketAddress^ socketAddress = ipLocalEndPoint->Serialize();

//Verifies that ipLocalEndPoint is now serialized by printing its contents.
Console::WriteLine( "Contents of the socketAddress are: {0}", socketAddress );
//Checks the Family property.
Console::WriteLine( "The address family of the socketAddress is: {0}", socketAddress->Family );
//Checks the underlying buffer size.
Console::WriteLine( "The size of the underlying buffer is: {0}", socketAddress->Size );

//Creates an IpEndPoint.
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);

//Serializes the IPEndPoint.
SocketAddress socketAddress = ipLocalEndPoint.Serialize();

//Verifies that ipLocalEndPoint is now serialized by printing its contents.
Console.WriteLine("Contents of the socketAddress are: " + socketAddress.ToString());
//Checks the Family property.
Console.WriteLine("The address family of the socketAddress is: " + socketAddress.Family.ToString());
//Checks the underlying buffer size.
Console.WriteLine("The size of the underlying buffer is: " + socketAddress.Size.ToString());

   'Creates an IpEndPoint.
   Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
   Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 11000)
   
   'Serializes the IPEndPoint. 
   Dim socketAddress As SocketAddress = ipLocalEndPoint.Serialize()
   
   'Verifies that ipLocalEndPoint is now serialized by printing its contents.
   Console.WriteLine(("Contents of socketAddress are: " + socketAddress.ToString()))
   'Checks the Family property.
   Console.WriteLine(("The address family of socketAddress is: " + socketAddress.Family.ToString()))
   'Checks the underlying buffer size.
   Console.WriteLine(("The size of the underlying buffer is: " + socketAddress.Size.ToString()))
End Sub

Remarques

Les 2 premiers octets de la mémoire tampon sous-jacente sont réservés à la AddressFamily valeur énumérée. Lorsque le SocketAddress est utilisé pour stocker un sérialisé IPEndPoint, les troisième et quatrième octets sont utilisés pour stocker les informations de numéro de port. Les octets suivants sont utilisés pour stocker l’adresse IP. Vous pouvez accéder à toutes les informations de cette mémoire tampon d’octets sous-jacente en faisant référence à sa position d’index ; la mémoire tampon d’octets utilise l’indexation de base zéro. Vous pouvez également utiliser les Family propriétés et Size pour obtenir respectivement la AddressFamily valeur et la taille de la mémoire tampon. Pour afficher l’une de ces informations sous forme de chaîne, utilisez la ToString méthode .

Constructeurs

SocketAddress(AddressFamily)	Crée une instance de la classe SocketAddress pour la famille d'adresses donnée.
SocketAddress(AddressFamily, Int32)	Crée une nouvelle instance de la classe SocketAddress en utilisant la famille d'adresses et la taille de mémoire tampon spécifiées.

Propriétés

Buffer	Obtient la mémoire sous-jacente qui peut être passée aux appels de système d’exploitation natifs.
Family	Obtient la valeur énumérée AddressFamily du SocketAddress actuel.
Item[Int32]	Obtient ou définit l'élément d'index spécifié dans la mémoire tampon sous-jacente.
Size	Obtient la taille de la mémoire tampon sous-jacente de SocketAddress.

Méthodes

Equals(Object)	Détermine si l'objet Object spécifié est égal à l'objet Object actuel.
Equals(SocketAddress)	Indique si l'objet actuel est égal à un autre objet du même type.
GetHashCode()	Sert de fonction de hachage pour un type particulier, convenant pour une utilisation dans les algorithmes de hachage et les structures de données telles qu'une table de hachage.
GetMaximumAddressSize(AddressFamily)	Obtient la taille de mémoire tampon maximale requise pour le donné AddressFamily.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne des informations sur l'adresse du socket.