Socket.LocalEndPoint Propriedade

  • Referência

Definição

Namespace:
System.Net.Sockets
Assemblies:
System.dll, System.Net.Sockets.dll
Assembly:
System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Obtém o ponto de extremidade local.

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

Valor da propriedade

EndPoint

O EndPoint que o Socket está usando para comunicações.

Exceções

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

Exemplos

O exemplo de código a seguir recupera e exibe os pontos de extremidade locais e remotos.

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

Comentários

A LocalEndPoint propriedade obtém um EndPoint que contém o endereço IP local e o número da porta ao qual você Socket está associado. Você deve converter isso EndPoint em um IPEndPoint antes de recuperar qualquer informação. Em seguida, você pode chamar o IPEndPoint.Address método para recuperar o local IPAddresse o IPEndPoint.Port método para recuperar o número da porta local.

A LocalEndPoint propriedade geralmente é definida depois que você faz uma chamada para o Bind método. Se você permitir que o sistema atribua o endereço IP local do soquete e o número da porta, a LocalEndPoint propriedade será definida após a primeira operação de E/S. Para protocolos orientados a conexão, a primeira operação de E/S seria uma chamada ao método ou Accept ao Connect método. Para protocolos sem conexão, a primeira operação de E/S seria qualquer uma das chamadas de envio ou recebimento.

Observação

Se você receber um SocketException, use a SocketException.ErrorCode propriedade para obter o código de erro específico. Depois de obter esse código, consulte a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

Aplica-se a

Confira também