Socket.RemoteEndPoint 속성

아티클
08/21/2007

원격 끝점을 가져옵니다.

네임스페이스: System.Net.Sockets
어셈블리: System(system.dll)

구문

‘선언
Public ReadOnly Property RemoteEndPoint As EndPoint
‘사용 방법
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

속성 값

Socket이 통신에 사용할 EndPoint입니다.

예외

예외 형식	조건
SocketException	소켓에 액세스하려고 시도하는 동안 오류가 발생한 경우. 자세한 내용은 설명 부분을 참조하십시오.
ObjectDisposedException	Socket이 닫힌 경우

설명

연결 지향 프로토콜을 사용하는 경우 RemoteEndPoint 속성은 Socket이 연결되는 원격 IP 주소와 포트 번호를 포함하는 EndPoint를 가져옵니다. 연결 없는 프로토콜을 사용하는 경우 RemoteEndPoint는 Socket이 통신할 기본 원격 IP 주소와 포트 번호를 포함합니다. 정보를 검색하기 전에 해당 EndPoint를 IPEndPoint로 캐스팅해야 합니다. 그런 다음 IPEndPoint.Address 메서드를 호출하여 원격 IPAddress를 검색하고 IPEndPoint.Port 메서드를 호출하여 원격 포트 번호를 검색할 수 있습니다.

RemoteEndPoint는 Accept 또는 Connect가 호출된 후에 설정됩니다. 이보다 먼저 이 속성에 액세스하려고 하면 RemoteEndPoint는 SocketException을 throw합니다. SocketException이 발생하면 SocketException.ErrorCode 속성을 사용하여 특정 오류 코드를 가져옵니다. 이 코드를 가져온 다음 MSDN Library의 Windows 소켓 버전 2 API 오류 코드 설명서에서 오류에 대한 자세한 설명을 참조하십시오.

참고

응용 프로그램에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 네트워크 추적을 참조하십시오.

예제

다음 코드 예제에서는 로컬 및 원격 끝점을 가져온 다음 표시합니다.

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

플랫폼

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

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

Socket 클래스
Socket 멤버
System.Net.Sockets 네임스페이스
EndPoint 클래스
Connect
Accept

다음을 통해 공유