TcpClient Konstruktory

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

Inicializuje novou instanci TcpClient třídy .

Přetížení

TcpClient()	Inicializuje novou instanci TcpClient třídy .
TcpClient(IPEndPoint)	Inicializuje novou instanci TcpClient třídy a vytvoří vazbu na zadaný místní koncový bod.
TcpClient(AddressFamily)	Inicializuje novou instanci TcpClient třídy se zadanou rodinou.
TcpClient(String, Int32)	Inicializuje novou instanci TcpClient třídy a připojí se k zadanému portu na zadaném hostiteli.

TcpClient()

Zdroj:

TCPClient.cs

Inicializuje novou instanci TcpClient třídy .

public:
 TcpClient();

public TcpClient ();

Public Sub New ()

Příklady

Následující příklad kódu ukazuje použití konstruktoru bez parametrů k vytvoření nového TcpClient.

//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

Poznámky

Tento konstruktor vytvoří nový TcpClient a umožní podkladovému poskytovateli služeb přiřadit nejvhodnější místní IP adresu a číslo portu. Před odesláním a příjmem dat je nutné nejprve volat metodu Connect .

Poznámka

V rozhraní .NET Framework funguje tento konstruktor pouze s typy adres IPv4.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(String, Int32)

TcpClient(IPEndPoint)

Zdroj:

TCPClient.cs

Inicializuje novou instanci TcpClient třídy a vytvoří vazbu na zadaný místní koncový bod.

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)

Parametry

localEP

IPEndPoint

Objekt IPEndPoint , se kterým vytvoříte vazbu tcp Socket.

Výjimky

ArgumentNullException

Parametr localEP je null.

Příklady

Následující příklad kódu ukazuje, jak vytvořit instanci TcpClient třídy pomocí místního koncového bodu.

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

Poznámky

Tento konstruktor vytvoří nový TcpClient a vytvoří vazbu na IPEndPoint hodnotu určenou parametrem localEP . Před voláním tohoto konstruktoru musíte vytvořit IPEndPoint pomocí IP adresy a čísla portu, ze kterého chcete odesílat a přijímat data. Před připojením a komunikací nemusíte zadávat místní IP adresu a číslo portu. Pokud vytvoříte pomocí jakéhokoli jiného TcpClient konstruktoru, přiřadí příslušný poskytovatel služeb nejvhodnější místní IP adresu a číslo portu.

Před odesláním a příjmem dat je nutné volat metodu Connect .

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

Zdroj:

TCPClient.cs

Inicializuje novou instanci TcpClient třídy se zadanou rodinou.

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)

Parametry

family

AddressFamily

Hodnota AddressFamily protokolu IP.

Výjimky

ArgumentException

Parametr family se nerovná parametru AddressFamily.InterNetwork.

-nebo-

Parametr family se nerovná parametru AddressFamily.InterNetworkV6.

Příklady

Následující příklad kódu ukazuje, jak vytvořit instanci TcpClient třídy.

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

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Poznámky

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

TcpClient(String, Int32)

Zdroj:

TCPClient.cs

Inicializuje novou instanci TcpClient třídy a připojí se k zadanému portu na zadaném hostiteli.

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)

Parametry

hostname

String

Název DNS vzdáleného hostitele, ke kterému se chcete připojit.

port

Int32

Číslo portu vzdáleného hostitele, ke kterému se chcete připojit.

Výjimky

ArgumentNullException

Parametr hostname je null.

ArgumentOutOfRangeException

Parametr port není mezi MinPort a MaxPort.

SocketException

Při přístupu k soketu došlo k chybě.

Příklady

Následující příklad kódu ukazuje, jak vytvořit instanci TcpClient třídy pomocí názvu hostitele a čísla portu.

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

Poznámky

Tento konstruktor vytvoří nový TcpClient a provede synchronní pokus o připojení k zadanému názvu hostitele a číslu portu. Poskytovatel podkladových služeb přiřadí nejvhodnější místní IP adresu a číslo portu. TcpClient bude blokovat, dokud se buď nepřipojí, nebo selže. Tento konstruktor umožňuje inicializovat, přeložit název hostitele DNS a připojit se v jednom pohodlném kroku.

Pokud je povolený protokol IPv6 a TcpClient(String, Int32) volá se metoda pro připojení k hostiteli, který se překládá na adresy IPv6 i IPv4, pokusí se o připojení k adrese IPv6 nejprve před adresou IPv4. Pokud hostitel nenaslouchá na adrese IPv6, může to zpozdit dobu navázání připojení.

Poznámka

Pokud se zobrazí SocketException, použijte SocketException.ErrorCode k získání konkrétního kódu chyby. Jakmile tento kód získáte, můžete se podívat do dokumentace k chybovému kódu rozhraní API rozhraní Windows Sockets verze 2 , kde najdete podrobný popis chyby.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• TcpClient
• Connect(String, Int32)