SocketAddress Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Stocke des informations sérialisées provenant des classes dérivées EndPoint.
public ref class SocketAddress
public ref class SocketAddress : IEquatable<System::Net::SocketAddress ^>
public class SocketAddress
public class SocketAddress : IEquatable<System.Net.SocketAddress>
type SocketAddress = class
type SocketAddress = class
interface IEquatable<SocketAddress>
Public Class SocketAddress
Public Class SocketAddress
Implements IEquatable(Of SocketAddress)
- Héritage
-
SocketAddress
- Implémente
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 |
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. |