TcpClient Costruttori

Definizione

Inizializza una nuova istanza della classe TcpClient.

Overload

Nome Descrizione
TcpClient()

Inizializza una nuova istanza della classe TcpClient.

TcpClient(IPEndPoint)

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

TcpClient(AddressFamily)

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

TcpClient(String, Int32)

Inizializza una nuova istanza della TcpClient classe e si connette alla porta specificata nell'host specificato.

TcpClient()

Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs
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 = 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 locale e il numero di porta più appropriati. È necessario chiamare il Connect metodo prima di inviare e ricevere dati.

Note

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

Note

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Network Tracing in the .NET Framework.

Vedi anche

Si applica a

TcpClient(IPEndPoint)

Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs

Inizializza una nuova istanza della TcpClient classe 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 si esegue il binding tcp Socket.

Eccezioni

Il localEP parametro è 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.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 IPEndPoint specificato dal localEP 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 utilizzando qualsiasi altro costruttore, il provider di servizi sottostante assegnerà l'indirizzo IP locale e il numero di porta più appropriati.

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

Note

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Network Tracing in the .NET Framework.

Vedi anche

Si applica a

TcpClient(AddressFamily)

Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs

Inizializza una nuova istanza della TcpClient classe 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

Oggetto AddressFamily del protocollo IP.

Eccezioni

Il family parametro non è uguale a AddressFamily.InterNetwork

oppure

Il family parametro non è uguale a AddressFamily.InterNetworkV6

Esempio

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

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);
Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Commenti

Note

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Network Tracing in the .NET Framework.

Si applica a

TcpClient(String, Int32)

Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs
Origine:
TCPClient.cs

Inizializza una nuova istanza della TcpClient classe e si connette alla porta specificata nell'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

Il hostname parametro è null.

Il port parametro non è compreso tra MinPort e MaxPort.

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 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 oggetto e esegue un tentativo di connessione sincrono al nome host e al numero di porta specificati. Il provider di servizi sottostante assegnerà l'indirizzo IP locale 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 unico passaggio pratico.

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

Note

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 relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Note

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Network Tracing in the .NET Framework.

Vedi anche

Si applica a