Socket.RemoteEndPoint-Eigenschaft

Artikel
08/20/2007

Ruft den Remoteendpunkt ab.

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

Syntax

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

value = instance.RemoteEndPoint

public EndPoint RemoteEndPoint { get; }

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

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

public function get RemoteEndPoint () : EndPoint

Eigenschaftenwert

Der EndPoint, mit dem der Socket kommuniziert.

Ausnahmen

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

Hinweise

Bei verbindungsorientierten Protokollen ruft die RemoteEndPoint-Eigenschaft den EndPoint ab, der die Remote-IP-Adresse und Anschlussnummer enthält, mit denen der Socket verbunden ist. Bei verbindungslosen Protokollen enthält RemoteEndPoint die Standardeinstellungen für die Remote-IP-Adresse und -Anschlussnummer, mit denen der Socket kommuniziert. Dieser EndPoint muss in einen IPEndPoint umgewandelt werden, bevor Informationen abgerufen werden können. Danach kann durch einen Aufruf der IPEndPoint.Address-Methode die Remote-IPAddress und mit der IPEndPoint.Port-Methode die Remote-Anschlussnummer abgerufen werden.

Der RemoteEndPoint wird nach einem Aufruf von Accept oder Connect festgelegt. Wenn Sie versuchen, vorher auf diese Eigenschaft zuzugreifen, wird eine RemoteEndPointSocketException ausgelöst. 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
Connect
Accept

Freigeben über