Socket.LocalEndPoint Proprietà

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Origine:

Socket.cs

Ottiene l'endpoint locale.

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

Valore della proprietà

EndPoint

L'oggetto EndPoint utilizzato dall'oggetto Socket per le comunicazioni.

Eccezioni

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

Esempio

L'esempio di codice seguente recupera e visualizza gli endpoint locali e remoti.

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

Commenti

La LocalEndPoint proprietà ottiene un EndPoint oggetto contenente l'indirizzo IP locale e il numero di porta a cui Socket è associato. È necessario eseguire il cast in EndPoint un oggetto IPEndPoint prima di recuperare tutte le informazioni. È quindi possibile chiamare il IPEndPoint.Address metodo per recuperare il valore locale e il IPEndPoint.Port metodo per recuperare il numero di porta localeIPAddress.

La LocalEndPoint proprietà viene in genere impostata dopo aver eseguito una chiamata al Bind metodo. Se si consente al sistema di assegnare l'indirizzo IP locale del socket e il numero di porta, la LocalEndPoint proprietà verrà impostata dopo la prima operazione di I/O. Per i protocolli orientati alla connessione, la prima operazione di I/O sarà una chiamata al Connect metodo o Accept . Per i protocolli senza connessione, la prima operazione di I/O sarà una delle chiamate di invio o ricezione.

Nota

Se si riceve un SocketExceptionoggetto , utilizzare la proprietà per ottenere il SocketException.ErrorCode codice di errore specifico. Dopo aver ottenuto questo codice, vedere la documentazione del codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Vedi anche

• EndPoint
• IPEndPoint
• Bind(EndPoint)