TcpClient Konstruktory

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.Sockets.dll

Inicjuje nowe wystąpienie klasy TcpClient.

Przeciążenia

TcpClient()	Inicjuje nowe wystąpienie klasy TcpClient.
TcpClient(IPEndPoint)	Inicjuje TcpClient nowe wystąpienie klasy i wiąże je z określonym lokalnym punktem końcowym.
TcpClient(AddressFamily)	Inicjuje TcpClient nowe wystąpienie klasy z określoną rodziną.
TcpClient(String, Int32)	Inicjuje TcpClient nowe wystąpienie klasy i łączy się z określonym portem na określonym hoście.

TcpClient()

Źródło:

TCPClient.cs

Inicjuje nowe wystąpienie klasy TcpClient.

public:
 TcpClient();

public TcpClient ();

Public Sub New ()

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć nowy TcpClientkonstruktor bez parametrów za pomocą konstruktora bez parametrów.

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

Uwagi

Ten konstruktor tworzy nowy TcpClient i umożliwia bazowemu dostawcy usług przypisanie najbardziej odpowiedniego lokalnego adresu IP i numeru portu. Musisz najpierw wywołać metodę Connect przed wysłaniem i odebraniem danych.

Uwaga

W .NET Framework ten konstruktor działa tylko z typami adresów IPv4.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Zobacz też

• Connect(String, Int32)

TcpClient(IPEndPoint)

Źródło:

TCPClient.cs

Inicjuje TcpClient nowe wystąpienie klasy i wiąże je z określonym lokalnym punktem końcowym.

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

Element IPEndPoint , z którym jest powiązany protokół TCP Socket.

Wyjątki

ArgumentNullException

Parametr localEP ma wartość null.

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć wystąpienie TcpClient klasy przy użyciu lokalnego punktu końcowego.

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

Uwagi

Ten konstruktor tworzy nowy TcpClient i wiąże go z IPEndPoint określonym przez localEP parametr . Przed wywołaniem tego konstruktora należy utworzyć IPEndPoint przy użyciu adresu IP i numeru portu, z którego zamierzasz wysyłać i odbierać dane. Nie musisz określać lokalnego adresu IP i numeru portu przed nawiązaniem połączenia i komunikacją. Jeśli utworzysz TcpClient przy użyciu dowolnego innego konstruktora, podstawowy dostawca usług przypisze najbardziej odpowiedni lokalny adres IP i numer portu.

Przed wysłaniem i odebraniem danych należy wywołać metodę Connect .

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Zobacz też

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

Źródło:

TCPClient.cs

Inicjuje TcpClient nowe wystąpienie klasy z określoną rodziną.

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

Protokół AddressFamily IP.

Wyjątki

ArgumentException

Parametr family nie jest równy AddressFamily.InterNetwork

-lub-

Parametr family nie jest równy AddressFamily.InterNetworkV6

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć wystąpienie TcpClient klasy.

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

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Uwagi

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

TcpClient(String, Int32)

Źródło:

TCPClient.cs

Inicjuje TcpClient nowe wystąpienie klasy i łączy się z określonym portem na określonym hoście.

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

Nazwa DNS hosta zdalnego, z którym zamierzasz nawiązać połączenie.

port

Int32

Numer portu hosta zdalnego, z którym zamierzasz nawiązać połączenie.

Wyjątki

ArgumentNullException

Parametr hostname ma wartość null.

ArgumentOutOfRangeException

Parametr port nie znajduje się między parametrami MinPort i MaxPort.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć wystąpienie TcpClient klasy przy użyciu nazwy hosta i numeru 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)

Uwagi

Ten konstruktor tworzy nowy TcpClient i podejmuje synchroniczną próbę nawiązania połączenia z podaną nazwą hosta i numerem portu. Podstawowy dostawca usług przypisze najbardziej odpowiedni lokalny adres IP i numer portu. TcpClient będzie blokować, dopóki nie zostanie nawiązane połączenie lub nie powiedzie się. Ten konstruktor umożliwia inicjowanie, rozpoznawanie nazwy hosta DNS i łączenie się w jednym wygodnym kroku.

Jeśli protokół IPv6 jest włączony, a TcpClient(String, Int32) metoda jest wywoływana w celu nawiązania połączenia z hostem rozpoznawanym zarówno adresami IPv6, jak i IPv4, połączenie z adresem IPv6 zostanie podjęta najpierw przed adresem IPv4. Może to mieć wpływ na opóźnienie czasu ustanowienia połączenia, jeśli host nie nasłuchuje na adresie IPv6.

Uwaga

Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Zobacz też

• TcpClient
• Connect(String, Int32)