SocketAddress Klasse

Definition

Speichert serialisierte Informationen von Klassen, die von EndPoint abgeleitet sind.

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)
Vererbung
SocketAddress
Implementiert

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie verwendenSocketAddress, um eine instance der EndPoint -Klasse zu serialisieren. Nach der Serialisierung enthält der zugrunde liegende Bytepuffer des SocketAddress alle Zustandsinformationen 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

Hinweise

Die ersten 2 Bytes des zugrunde liegenden Puffers sind für den AddressFamily enumerierten Wert reserviert. Wenn verwendet SocketAddress wird, um eine serialisierte IPEndPointzu speichern, werden die dritten und vierten Bytes verwendet, um Informationen zur Portnummer zu speichern. Die nächsten Bytes werden verwendet, um die IP-Adresse zu speichern. Sie können auf alle Informationen innerhalb dieses zugrunde liegenden Bytepuffers zugreifen, indem Sie auf dessen Indexposition verweisen. Der Bytepuffer verwendet die nullbasierte Indizierung. Sie können auch die Family und Size Eigenschaften zum Abrufen der AddressFamily Wert und der Puffer die Größe, bzw. Verwenden Sie die ToString -Methode, um diese Informationen als Zeichenfolge anzuzeigen.

Konstruktoren

SocketAddress(AddressFamily)

Erstellt eine neue Instanz der SocketAddress-Klasse für die angegebene Adressfamilie.

SocketAddress(AddressFamily, Int32)

Erstellt eine neue Instanz der SocketAddress-Klasse, wobei die angegebene Adressfamilie und die angegebene Puffergröße verwendet werden.

Eigenschaften

Buffer

Ruft den zugrunde liegenden Arbeitsspeicher ab, der an systemeigene Betriebssystemaufrufe übergeben werden kann.

Family

Ruft den AddressFamily-Enumerationswert der aktuellen SocketAddress ab.

Item[Int32]

Ruft das angegebene Indexelement im zugrunde liegenden Puffer ab oder legt dieses fest.

Size

Ruft die Größe des zugrunde liegenden Puffers der SocketAddress ab.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind.

Equals(SocketAddress)

Gibt an, ob das aktuelle Objekt gleich einem anderen Objekt des gleichen Typs ist.

GetHashCode()

Dient als Hashfunktion für einen bestimmten Typ, die in Hashalgorithmen und Datenstrukturen (z. B. Hashtabellen) verwendet werden kann.

GetMaximumAddressSize(AddressFamily)

Ruft die maximal erforderliche Puffergröße für die angegebene AddressFamilyab.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt Informationen über die Socketadresse zurück.

Gilt für: