SocketAddress Clase

  • Referencia

Definición

Espacio de nombres:
System.Net
Ensamblados:
System.dll, System.Net.Primitives.dll
Ensamblado:
System.Net.Primitives.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll
Source:
SocketAddress.cs
Source:
SocketAddress.cs
Source:
SocketAddress.cs

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

Se aplica a