SocketAddress Classe

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.Primitives.dll

Origine:

SocketAddress.cs

Archivia le informazioni serializzate dalla classi derivate 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)

Ereditarietà

Object

SocketAddress

Implementazioni

IEquatable<SocketAddress>

Esempio

Nell'esempio seguente viene illustrato come usare SocketAddress per serializzare un'istanza della EndPoint classe. Dopo la serializzazione, il buffer di byte sottostante dell'oggetto SocketAddress contiene tutte le informazioni sullo IPEndPoint stato.

//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

Commenti

I primi 2 byte del buffer sottostante sono riservati al AddressFamily valore enumerato. Quando viene SocketAddress usato per archiviare un oggetto serializzato , il terzo e quarto byte IPEndPointvengono usati per archiviare le informazioni sul numero di porta. I byte successivi vengono usati per archiviare l'indirizzo IP. È possibile accedere a tutte le informazioni all'interno di questo buffer byte sottostante facendo riferimento alla sua posizione di indice; il buffer di byte usa l'indicizzazione in base zero. È anche possibile usare le Family proprietà e Size per ottenere rispettivamente il valore e le AddressFamily dimensioni del buffer. Per visualizzare una di queste informazioni come stringa, usare il ToString metodo .

Costruttori

SocketAddress(AddressFamily)	Crea una nuova istanza della classe SocketAddress per la determinata famiglia di indirizzi.
SocketAddress(AddressFamily, Int32)	Crea una nuova istanza della classe SocketAddress utilizzando la famiglia di indirizzi e la dimensione del buffer specificati.

Proprietà

Buffer	Ottiene la memoria sottostante che può essere passata alle chiamate del sistema operativo native.
Family	Recupera il valore enumerato di AddressFamily del SocketAddress corrente.
Item[Int32]	Recupera o imposta l'elemento indice specificato nel buffer sottostante.
Size	Recupera la dimensione del buffer sottostante di SocketAddress.

Metodi

Equals(Object)	Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente.
Equals(SocketAddress)	Indica se l'oggetto corrente è uguale a un altro oggetto dello stesso tipo.
GetHashCode()	Serve come funzione hash per un tipo particolare ed è appropriato per l'utilizzo in algoritmi di hashing e strutture di dati quali tabelle hash.
GetMaximumAddressSize(AddressFamily)	Ottiene la dimensione massima del buffer necessaria per l'oggetto specificato AddressFamily.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce le informazioni sull'indirizzo socket.