TcpClient Costruttori

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Inizializza una nuova istanza della classe TcpClient.

Overload

TcpClient()	Inizializza una nuova istanza della classe TcpClient.
TcpClient(IPEndPoint)	Inizializza una nuova istanza della classe TcpClient e la associa all'endpoint locale specificato.
TcpClient(AddressFamily)	Inizializza una nuova istanza della classe TcpClient con la famiglia specificata.
TcpClient(String, Int32)	Inizializza una nuova istanza della classe TcpClient ed effettua la connessione alla porta specificata sull'host specificato.

TcpClient()

Origine:

TCPClient.cs

Inizializza una nuova istanza della classe TcpClient.

public:
 TcpClient();

public TcpClient ();

Public Sub New ()

Esempio

Nell'esempio di codice seguente viene illustrato come usare il costruttore senza parametri per creare un nuovo TcpClientoggetto .

//Creates a TCPClient using the default constructor.
TcpClient^ tcpClientC = gcnew TcpClient;

//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient ();

'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient

Commenti

Questo costruttore crea un nuovo TcpClient e consente al provider di servizi sottostante di assegnare l'indirizzo IP e il numero di porta più appropriati. È prima necessario chiamare il Connect metodo prima di inviare e ricevere dati.

Nota

In .NET Framework questo costruttore funziona solo con i tipi di indirizzi IPv4.

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

• Connect(String, Int32)

TcpClient(IPEndPoint)

Origine:

TCPClient.cs

Inizializza una nuova istanza della classe TcpClient e la associa all'endpoint locale specificato.

public:
 TcpClient(System::Net::IPEndPoint ^ localEP);

public TcpClient (System.Net.IPEndPoint localEP);

new System.Net.Sockets.TcpClient : System.Net.IPEndPoint -> System.Net.Sockets.TcpClient

Public Sub New (localEP As IPEndPoint)

Parametri

localEP

IPEndPoint

Oggetto IPEndPoint a cui associare il Socket TCP.

Eccezioni

ArgumentNullException

Il valore del parametro localEP è null.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un'istanza della TcpClient classe usando un endpoint locale.

//Creates a TCPClient using a local end point.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );
TcpClient^ tcpClientA = gcnew TcpClient( ipLocalEndPoint );

//Creates a TCPClient using a local end point.
IPAddress ipAddress = Dns.GetHostEntry (Dns.GetHostName ()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 0);
TcpClient tcpClientA = new TcpClient (ipLocalEndPoint);

'Creates a TCPClient using a local endpoint.
Dim ipAddress As IPAddress = Dns.GetHostEntry(Dns.GetHostName()).AddressList(0)
   Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 0)

   Dim tcpClientA As New TcpClient(ipLocalEndPoint)

Commenti

Questo costruttore crea un nuovo TcpClient oggetto e lo associa all'oggetto IPEndPointlocalEP specificato dal parametro . Prima di chiamare questo costruttore, è necessario creare un IPEndPoint oggetto usando l'indirizzo IP e il numero di porta da cui si intende inviare e ricevere dati. Non è necessario specificare un indirizzo IP locale e un numero di porta prima di connettersi e comunicare. Se si crea un TcpClient oggetto usando qualsiasi altro costruttore, il provider di servizi sottostante assegna il numero di porta e l'indirizzo IP locale più appropriato.

È necessario chiamare il Connect metodo prima di inviare e ricevere dati.

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

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

Origine:

TCPClient.cs

Inizializza una nuova istanza della classe TcpClient con la famiglia specificata.

public:
 TcpClient(System::Net::Sockets::AddressFamily family);

public TcpClient (System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.TcpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.TcpClient

Public Sub New (family As AddressFamily)

Parametri

family

AddressFamily

La AddressFamily del protocollo IP.

Eccezioni

ArgumentException

Il parametro family non è uguale a AddressFamily.InterNetwork

-oppure-

Il parametro family non è uguale a AddressFamily.InterNetworkV6

Esempio

Nell'esempio di codice seguente viene illustrato come creare un'istanza della TcpClient classe.

TcpClient^ tcpClientD = gcnew TcpClient( AddressFamily::InterNetwork );

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Commenti

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.

TcpClient(String, Int32)

Origine:

TCPClient.cs

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

public:
 TcpClient(System::String ^ hostname, int port);

public TcpClient (string hostname, int port);

new System.Net.Sockets.TcpClient : string * int -> System.Net.Sockets.TcpClient

Public Sub New (hostname As String, port As Integer)

Parametri

hostname

String

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

port

Int32

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

Eccezioni

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.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un'istanza della TcpClient classe usando un nome host e un numero di porta.

// Creates a TCPClient using hostname and port.
TcpClient^ tcpClientB = gcnew TcpClient( "www.contoso.com",11000 );

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

'Creates a TCPClient using hostname and port.

Dim tcpClientB As New TcpClient("www.contoso.com", 11000)

Commenti

Questo costruttore crea un nuovo TcpClient e esegue un tentativo di connessione sincrono al nome host e al numero di porta specificati. Il provider di servizi sottostante assegna l'indirizzo IP e il numero di porta più appropriati. TcpClient bloccherà finché non si connette o non riesce. Questo costruttore consente di inizializzare, risolvere il nome host DNS e connettersi in un passaggio pratico.

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

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla 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

• TcpClient
• Connect(String, Int32)