SocketAddress 類別

定義

命名空間:

System.Net

組件:

System.Net.Primitives.dll

來源:

SocketAddress.cs

儲存 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)

繼承

Object

SocketAddress

實作

IEquatable<SocketAddress>

範例

下列範例示範如何使用 SocketAddress 來串行化 類別的 EndPoint 實例。 串行化之後，的基礎位元組緩衝區 SocketAddress 會包含所有 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

備註

基礎緩衝區的前 2 個字節會保留給 AddressFamily 列舉值。 SocketAddress當 用來儲存串行化的 IPEndPoint時，會使用第三個和第四個字節來儲存埠號碼資訊。 下一個字節是用來儲存IP位址。 您可以藉由參考其索引位置來存取此基礎位元組緩衝區內的任何資訊;位元組緩衝區使用以零起始的索引。 您也可以使用 Family 和 Size 屬性來分別取得 AddressFamily 值和緩衝區大小。 若要將這項信息視為字串檢視，請使用 ToString 方法。

建構函式

SocketAddress(AddressFamily)	為指定的通訊協定家族 (Address Family) 建立 SocketAddress 類別的新執行個體。
SocketAddress(AddressFamily, Int32)	使用指定的通訊協定家族和緩衝區大小來初始化 SocketAddress 類別的新執行個體。

屬性

Buffer	取得可傳遞至原生OS呼叫的基礎記憶體。
Family	取得目前 AddressFamily 的 SocketAddress 列舉值。
Item[Int32]	取得或設定基礎緩衝區中的指定索引項目。
Size	取得 SocketAddress 的基礎緩衝區大小。

方法

Equals(Object)	判斷指定的 Object 是否等於目前的 Object。
Equals(SocketAddress)	指出目前的物件是否等於另一個相同類型的物件。
GetHashCode()	做為特定類型的雜湊函數，適用於雜湊演算法和資料結構 (例如雜湊資料表)。
GetMaximumAddressSize(AddressFamily)	取得指定 AddressFamily所需的緩衝區大小上限。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回通訊端 (Socket) 位址的相關資訊。