Socket.LocalEndPoint Eigenschaft

Definition

Ruft den lokalen Endpunkt ab.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

Eigenschaftswert

Der EndPoint, den der Socket für die Kommunikation verwendet.The EndPoint that the Socket is using for communications.

Ausnahmen

Fehler beim Versuch, auf den Socket zuzugreifen.An error occurred when attempting to access the socket.

Der Socket wurde geschlossen.The Socket has been closed.

Beispiele

Im folgenden Codebeispiel werden die lokalen und Remote Endpunkte abgerufen und angezeigt.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())

Hinweise

Die LocalEndPoint-Eigenschaft ruft eine EndPoint ab, die die lokale IP-Adresse und die Portnummer enthält, an die ihr Socket gebunden ist.The LocalEndPoint property gets an EndPoint that contains the local IP address and port number to which your Socket is bound. Sie müssen diese EndPoint in eine IPEndPoint umwandeln, bevor Sie Informationen abrufen.You must cast this EndPoint to an IPEndPoint before retrieving any information. Sie können dann die IPEndPoint.Address-Methode aufrufen, um den lokalen IPAddressabzurufen, und die IPEndPoint.Port-Methode, um die lokale Portnummer abzurufen.You can then call the IPEndPoint.Address method to retrieve the local IPAddress, and the IPEndPoint.Port method to retrieve the local port number.

Die LocalEndPoint-Eigenschaft wird normalerweise festgelegt, nachdem Sie die Bind-Methode aufgerufen haben.The LocalEndPoint property is usually set after you make a call to the Bind method. Wenn Sie zulassen, dass das System die lokale IP-Adresse und Portnummer Ihres Sockets zuweist, wird die LocalEndPoint-Eigenschaft nach dem ersten e/a-Vorgang festgelegt.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. Bei Verbindungs orientierten Protokollen wäre der erste e/a-Vorgang ein aufzurufende Connect-oder Accept Methode.For connection-oriented protocols, the first I/O operation would be a call to the Connect or Accept method. Bei Verbindungs losen Protokollen wäre der erste e/a-Vorgang einer der Sende-oder Empfangs Aufrufe.For connectionless protocols, the first I/O operation would be any of the send or receive calls.

Hinweis

Wenn Sie erhalten eine SocketException, verwenden die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode zu erhalten.If you receive a SocketException, use the SocketException.ErrorCode property to obtain the specific error code. Nachdem Sie diesen Code abgerufen haben, finden Sie in der API-Fehlercode Dokumentation der Windows Sockets, Version 2 , eine ausführliche Beschreibung des Fehlers.After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

Gilt für:

Siehe auch