Socket.LocalEndPoint Propriedade

Definição

Obtém o ponto de extremidade local.Gets the local endpoint.

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.The EndPoint that the Socket is using for communications.

Exceções

Ocorreu um erro ao tentar acessar o soquete.An error occurred when attempting to access the socket.

O Socket foi fechado.The Socket has been closed.

Exemplos

O exemplo de código a seguir recupera e exibe os pontos de extremidade locais e remotos.The following code example retrieves and displays the local and remote endpoints.

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 seu Socket está associado.The LocalEndPoint property gets an EndPoint that contains the local IP address and port number to which your Socket is bound. Você deve convertê-lo EndPoint em um IPEndPoint antes de recuperar qualquer informação.You must cast this EndPoint to an IPEndPoint before retrieving any information. Em seguida, você pode chamar o IPEndPoint.Address método para recuperar o local IPAddress e o IPEndPoint.Port método para recuperar o número da porta local.You can then call the IPEndPoint.Address method to retrieve the local IPAddress, and the IPEndPoint.Port method to retrieve the local port number.

A LocalEndPoint propriedade é geralmente definida depois que você faz uma chamada para o Bind método.The LocalEndPoint property is usually set after you make a call to the Bind method. Se você permitir que o sistema atribua o endereço IP local e o número da porta do soquete, a LocalEndPoint propriedade será definida após a primeira operação de e/s.If you allow the system to assign your socket's local IP address and port number, the LocalEndPoint property will be set after the first I/O operation. Para protocolos orientados a conexão, a primeira operação de e/s seria uma chamada para Connect o Accept método ou.For connection-oriented protocols, the first I/O operation would be a call to the Connect or Accept method. Para protocolos sem conexão, a primeira operação de e/s seria qualquer uma das chamadas de envio ou recebimento.For connectionless protocols, the first I/O operation would be any of the send or receive calls.

Observação

Se você receber um SocketException , use a SocketException.ErrorCode propriedade para obter o código de erro específico.If you receive a SocketException, use the SocketException.ErrorCode property to obtain the specific error code. 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.After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Aplica-se a

Confira também