Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Costruttore TcpClient (String, Int32)

 

Data di pubblicazione: ottobre 2016

Inizializza una nuova istanza della classe TcpClient ed effettua la connessione alla porta specificata sull'host specificato.

Spazio dei nomi:   System.Net.Sockets
Assembly:  System (in System.dll)

public TcpClient(
	string hostname,
	int port
)

Parametri

hostname
Type: System.String

Nome DNS dell'host remoto a cui si intende connettersi.

port
Type: System.Int32

Numero di porta dell'host remoto a cui si intende connettersi.

Exception Condition
ArgumentNullException

Il valore del parametro hostname è null.

ArgumentOutOfRangeException

Il parametro port non è compreso tra MinPort e MaxPort.

SocketException

Si è verificato un errore durante l'accesso al socket. Per altre informazioni, vedere la sezione Osservazioni.

Questo costruttore crea un nuovo TcpClient ed effettua una connessione sincrona tentativo con il nome host specificato e il numero di porta. Il provider del servizio sottostante assegnerà il numero porta e indirizzo IP locale più appropriato. TcpClient si bloccherà fino a quando la connessione avrà esito positivo o negativo. Questo costruttore consente di inizializzare, risolvere il nome host DNS e la connessione in un solo passaggio.

Se IPv6 è attivato e TcpClient(String, Int32) metodo viene chiamato per connettersi a un host che si risolve in IPv6 e indirizzi IPv4, la connessione all'indirizzo IPv6 verrà tentata prima l'indirizzo IPv4. Ciò può avere l'effetto di ritardare il tempo necessario per stabilire la connessione se l'host non è in ascolto sull'indirizzo IPv6.

System_CAPS_noteNota

Se si riceve un SocketException, utilizzare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo avere ottenuto il codice, è possibile fare riferimento alla documentazione relativa ai codici di errore dell'API Windows Sockets versione 2 disponibile in MSDN per una descrizione dettagliata dell'errore.

System_CAPS_noteNota

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

Esempio di codice riportato di seguito viene illustrato come creare un'istanza di TcpClient classe utilizzando un nome host e il numero di porta.

//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient ("www.contoso.com", 11000);

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: