SocketAddress Clase

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Primitives.dll

Source:

SocketAddress.cs

Almacena información serializada procedente de clases derivadas de 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)

Herencia

Object

SocketAddress

Implementaciones

IEquatable<SocketAddress>

Ejemplos

En el ejemplo siguiente se muestra cómo usar SocketAddress para serializar una instancia de la EndPoint clase . Después de la serialización, el búfer de bytes subyacente de SocketAddress contiene toda la IPEndPoint información de estado.

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

Comentarios

Los primeros 2 bytes del búfer subyacente se reservan para el AddressFamily valor enumerado. SocketAddress Cuando se usa para almacenar un serializado IPEndPoint, los bytes tercero y cuarto se usan para almacenar la información del número de puerto. Los bytes siguientes se usan para almacenar la dirección IP. Puede acceder a cualquier información dentro de este búfer de bytes subyacente haciendo referencia a su posición de índice; El búfer de bytes usa la indexación basada en cero. También puede usar las Family propiedades y Size para obtener el AddressFamily valor y el tamaño del búfer, respectivamente. Para ver cualquiera de esta información como una cadena, use el ToString método .

Constructores

SocketAddress(AddressFamily)	Crea una nueva instancia de la clase SocketAddress para la familia de direcciones dada.
SocketAddress(AddressFamily, Int32)	Crea una nueva instancia de la clase SocketAddress con la familia de direcciones y el tamaño de búfer especificados.

Propiedades

Buffer	Obtiene la memoria subyacente que se puede pasar a las llamadas nativas del sistema operativo.
Family	Obtiene el valor enumerado AddressFamily del objeto SocketAddress actual.
Item[Int32]	Obtiene o establece el elemento de índice especificado en el búfer subyacente.
Size	Obtiene el tamaño del búfer subyacente del objeto SocketAddress.

Métodos

Equals(Object)	Determina si el objeto Object especificado es igual al objeto Object actual.
Equals(SocketAddress)	Indica si el objeto actual es igual que otro objeto del mismo tipo.
GetHashCode()	Actúa como una función hash para un tipo determinado, para su uso en algoritmos hash y en estructuras de datos como las tablas hash.
GetMaximumAddressSize(AddressFamily)	Obtiene el tamaño máximo de búfer necesario para el especificado AddressFamily.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve información acerca de la dirección del socket.