Socket.LocalEndPoint プロパティ

定義

ローカル エンドポイントを取得します。Gets the local endpoint.

public:
 property System::Net::EndPoint ^ LocalEndPoint { System::Net::EndPoint ^ get(); };
public System.Net.EndPoint LocalEndPoint { get; }
member this.LocalEndPoint : System.Net.EndPoint
Public ReadOnly Property LocalEndPoint As EndPoint

プロパティ値

EndPoint が通信に使用している SocketThe EndPoint that the Socket is using for communications.

例外

ソケットへのアクセスを試行しているときにエラーが発生しました。An error occurred when attempting to access the socket.

Socket が閉じられました。The Socket has been closed.

次のコード例では、ローカルとリモートのエンドポイントを取得して表示します。The following code example retrieves and displays the local and remote endpoints.

s->Connect( lep );

// Uses the RemoteEndPoint property.
Console::WriteLine(  "I am connected to {0} on port number {1}",
   IPAddress::Parse( ( ( (IPEndPoint^)(s->RemoteEndPoint) )->Address)->ToString() ),
   ( (IPEndPoint^)(s->RemoteEndPoint) )->Port.ToString() );

// Uses the LocalEndPoint property.
Console::Write(  "My local IpAddress is : {0}\nI am connected on port number {1}",
   IPAddress::Parse( ( ( (IPEndPoint^)(s->LocalEndPoint) )->Address)->ToString() ),
   ( (IPEndPoint^)(s->LocalEndPoint) )->Port.ToString() );
s.Connect (lep);

// Using the RemoteEndPoint property.
Console.WriteLine ("I am connected to " + IPAddress.Parse (((IPEndPoint)s.RemoteEndPoint).Address.ToString ()) + "on port number " + ((IPEndPoint)s.RemoteEndPoint).Port.ToString ());

// Using the LocalEndPoint property.
Console.WriteLine ("My local IpAddress is :" + IPAddress.Parse (((IPEndPoint)s.LocalEndPoint).Address.ToString ()) + "I am connected on port number " + ((IPEndPoint)s.LocalEndPoint).Port.ToString ());

s.Connect(lep)

' Using the RemoteEndPoint property.
Console.WriteLine("I am connected to ")
Console.WriteLine(IPAddress.Parse(CType(s.RemoteEndPoint, IPEndPoint).Address.ToString()))
Console.WriteLine("on port number ")
Console.WriteLine(CType(s.RemoteEndPoint, IPEndPoint).Port.ToString())

' Using the LocalEndPoint property.
Console.WriteLine("My local IpAddress is :")
Console.WriteLine(IPAddress.Parse(CType(s.LocalEndPoint, IPEndPoint).Address.ToString()))
Console.WriteLine("I am connected on port number ")
Console.WriteLine(CType(s.LocalEndPoint, IPEndPoint).Port.ToString())

注釈

LocalEndPoint プロパティは、Socket がバインドされているローカル IP アドレスとポート番号を含む EndPoint を取得します。The LocalEndPoint property gets an EndPoint that contains the local IP address and port number to which your Socket is bound. 情報を取得する前に、この EndPointIPEndPoint にキャストする必要があります。You must cast this EndPoint to an IPEndPoint before retrieving any information. その後、IPEndPoint.Address メソッドを呼び出してローカル IPAddressを取得し、IPEndPoint.Port メソッドを呼び出してローカルポート番号を取得できます。You can then call the IPEndPoint.Address method to retrieve the local IPAddress, and the IPEndPoint.Port method to retrieve the local port number.

LocalEndPoint プロパティは、通常、Bind メソッドを呼び出した後に設定されます。The LocalEndPoint property is usually set after you make a call to the Bind method. ソケットのローカル IP アドレスとポート番号の割り当てをシステムに許可した場合、最初の i/o 操作の後に LocalEndPoint プロパティが設定されます。If you allow the system to assign your socket's local IP address and port number, the LocalEndPoint property will be set after the first I/O operation. 接続指向プロトコルの場合、最初の i/o 操作は Connect または Accept メソッドの呼び出しになります。For connection-oriented protocols, the first I/O operation would be a call to the Connect or Accept method. コネクションレスプロトコルの場合、最初の i/o 操作は、送信または受信呼び出しのいずれかになります。For connectionless protocols, the first I/O operation would be any of the send or receive calls.

注意

SocketExceptionを受け取った場合は、SocketException.ErrorCode プロパティを使用して、特定のエラーコードを取得します。If you receive a SocketException, use the SocketException.ErrorCode property to obtain the specific error code. このコードを取得したら、 Windows Sockets version 2 API エラーコードのドキュメントを参照して、エラーの詳細な説明を参照してください。After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in the .NET Framework.

適用対象

こちらもご覧ください