Socket.LocalEndPoint-Eigenschaft

Artikel
08/20/2007

Ruft den lokalen Endpunkt ab.

Namespace: System.Net.Sockets
Assembly: System (in system.dll)

Syntax

'Declaration
Public ReadOnly Property LocalEndPoint As EndPoint
'Usage
Dim instance As Socket
Dim value As EndPoint

value = instance.LocalEndPoint

public EndPoint LocalEndPoint { get; }

public:
property EndPoint^ LocalEndPoint {
    EndPoint^ get ();
}

/** @property */
public EndPoint get_LocalEndPoint ()

public function get LocalEndPoint () : EndPoint

Eigenschaftenwert

Der EndPoint, den der Socket für die Kommunikation verwendet.

Ausnahmen

Ausnahmetyp	Bedingung
SocketException	Fehler beim Zugriff auf den Socket. Weitere Informationen finden Sie im Abschnitt Hinweise.
ObjectDisposedException	Der Socket wurde geschlossen.

Hinweise

Die LocalEndPoint-Eigenschaft ruft einen EndPoint ab, der die lokale IP-Adresse und Anschlussnummer enthält, an die der Socket gebunden ist. Dieser EndPoint muss in einen IPEndPoint umgewandelt werden, bevor Informationen abgerufen werden können. Danach kann durch einen Aufruf der IPEndPoint.Address-Methode die lokale IPAddress und mit der IPEndPoint.Port-Methode die lokale Anschlussnummer abgerufen werden.

Im Allgemeinen wird die LocalEndPoint-Eigenschaft nach dem Aufruf der Bind-Methode festgelegt. Wenn es möglich ist, die lokale IP-Adresse und Anschlussnummer des Sockets durch das System zuweisen zu lassen, wird die LocalEndPoint-Eigenschaft nach dem ersten E/A-Vorgang festgelegt. Bei verbindungsorientierten Protokollen ist der erste E/A-Vorgang ein Aufruf der Connect-Methode oder der Accept-Methode. Bei verbindungslosen Protokollen ist der erste E/A-Vorgang ein Aufruf für das Senden oder Empfangen von Daten.

Hinweis

Wenn Sie eine SocketException erhalten, können Sie mit der SocketException.ErrorCode-Eigenschaft den spezifischen Fehlercode abrufen. Nachdem Sie diesen Code abgerufen haben, finden Sie in der Dokumentation der MSDN Library zu API-Fehlercodes unter Windows Sockets, Version 2, eine ausführliche Beschreibung des Fehlers.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung.

Beispiel

Im folgenden Codebeispiel werden die lokalen und Remoteendpunkte abgerufen und angezeigt.

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())

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 );

// 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.get_RemoteEndPoint()).
    get_Address().ToString()) + "on port number " 
    + ((IPEndPoint)s.get_RemoteEndPoint()).get_Port());
// Using the LocalEndPoint property.
Console.WriteLine("My local IpAddress is :" 
    + IPAddress.Parse(((IPEndPoint)s.get_LocalEndPoint()).
    get_Address().ToString()) + "I am connected on port number " 
    + ((IPEndPoint)s.get_LocalEndPoint()).get_Port());

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Socket-Klasse
Socket-Member
System.Net.Sockets-Namespace
EndPoint-Klasse
IPEndPoint-Klasse
Bind

Freigeben über