Socket.LocalEndPoint Propriedade

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Origem:

Socket.cs

Obtém o ponto de extremidade local.

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

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 o 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 para o Connect método ou Accept . 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 em .NET Framework.

Confira também

• EndPoint
• IPEndPoint
• Bind(EndPoint)