SocketAddress Klasse

Definition

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

Quelle:

SocketAddress.cs

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

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)

Vererbung

Object

SocketAddress

Implementiert

IEquatable<SocketAddress>

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie SocketAddress eine Instanz der EndPoint -Klasse serialisiert wird. 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 aufgezählten Wert reserviert. Wenn zum SocketAddress Speichern eines serialisierten IPEndPointBytes verwendet wird, werden die dritten und vierten Bytes zum Speichern von Portnummerninformationen verwendet. 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 die Indexposition verweisen. der Bytepuffer verwendet 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 eine dieser 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 maximale erforderliche Puffergröße für den angegebenen 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.