TcpClient Oluşturucular

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

TcpClient sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

TcpClient()	TcpClient sınıfının yeni bir örneğini başlatır.
TcpClient(IPEndPoint)	sınıfının yeni bir örneğini TcpClient başlatır ve belirtilen yerel uç noktaya bağlar.
TcpClient(AddressFamily)	Belirtilen aile ile sınıfının yeni bir örneğini TcpClient başlatır.
TcpClient(String, Int32)	sınıfının yeni bir örneğini TcpClient başlatır ve belirtilen konakta belirtilen bağlantı noktasına bağlanır.

TcpClient()

Kaynak:

TCPClient.cs

TcpClient sınıfının yeni bir örneğini başlatır.

public:
 TcpClient();

public TcpClient ();

Public Sub New ()

Örnekler

Aşağıdaki kod örneği, yeni TcpClientbir oluşturmak için parametresiz oluşturucunun nasıl kullanılacağını gösterir.

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

Açıklamalar

Bu oluşturucu yeni TcpClient bir oluşturur ve temel alınan hizmet sağlayıcısının en uygun yerel IP adresini ve bağlantı noktası numarasını atamasını sağlar. Veri göndermeden ve almadan önce yöntemini çağırmanız Connect gerekir.

Not

.NET Framework bu oluşturucu yalnızca IPv4 adres türleriyle çalışır.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için .NET Framework ağ izleme bölümüne bakın.

Ayrıca bkz.

• Connect(String, Int32)

TcpClient(IPEndPoint)

Kaynak:

TCPClient.cs

sınıfının yeni bir örneğini TcpClient başlatır ve belirtilen yerel uç noktaya bağlar.

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)

Parametreler

localEP

IPEndPoint

TCP'yi IPEndPointSocketbağladığınız .

Özel durumlar

ArgumentNullException

localEP parametresidirnull.

Örnekler

Aşağıdaki kod örneği, yerel uç nokta kullanarak sınıfının bir örneğinin TcpClient nasıl oluşturulacağını gösterir.

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

Açıklamalar

Bu oluşturucu yeni TcpClient bir oluşturur ve parametresi tarafından belirtilene IPEndPointlocalEP bağlar. Bu oluşturucuyu çağırmadan önce, veri gönderip almak istediğiniz IP adresini ve bağlantı noktası numarasını kullanarak bir IPEndPoint oluşturmanız gerekir. Bağlanmadan ve iletişim kurmadan önce yerel bir IP adresi ve bağlantı noktası numarası belirtmeniz gerekmez. Başka bir oluşturucu kullanarak bir TcpClient oluşturursanız, temel alınan hizmet sağlayıcısı en uygun yerel IP adresini ve bağlantı noktası numarasını atar.

Veri göndermeden ve almadan önce yöntemini çağırmanız Connect gerekir.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için .NET Framework ağ izleme bölümüne bakın.

Ayrıca bkz.

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

Kaynak:

TCPClient.cs

Belirtilen aile ile sınıfının yeni bir örneğini TcpClient başlatır.

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)

Parametreler

family

AddressFamily

AddressFamily IP protokolünün.

Özel durumlar

ArgumentException

family Parametresi AddressFamily.InterNetwork'e eşit değil

-veya-

family Parametresi AddressFamily.InterNetworkV6'ya eşit değil

Örnekler

Aşağıdaki kod örneğinde sınıfının bir örneğinin nasıl oluşturulacağı gösterilmektedir TcpClient .

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

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Açıklamalar

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için .NET Framework ağ izleme bölümüne bakın.

TcpClient(String, Int32)

Kaynak:

TCPClient.cs

sınıfının yeni bir örneğini TcpClient başlatır ve belirtilen konakta belirtilen bağlantı noktasına bağlanır.

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)

Parametreler

hostname

String

Bağlanmak istediğiniz uzak konağın DNS adı.

port

Int32

Bağlanmak istediğiniz uzak konağın bağlantı noktası numarası.

Özel durumlar

ArgumentNullException

hostname parametresidirnull.

ArgumentOutOfRangeException

port parametresi ile MaxPortarasında MinPort değil.

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, konak adı ve bağlantı noktası numarası kullanarak sınıfının bir örneğinin TcpClient nasıl oluşturulacağını gösterir.

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

Açıklamalar

Bu oluşturucu yeni TcpClient bir oluşturur ve sağlanan ana bilgisayar adı ve bağlantı noktası numarasına zaman uyumlu bir bağlantı girişiminde bulunur. Temel alınan hizmet sağlayıcısı en uygun yerel IP adresini ve bağlantı noktası numarasını atar. TcpClient bağlanıncaya veya başarısız olana kadar engeller. Bu oluşturucu, DNS ana bilgisayar adını başlatmanıza, çözümlemenize ve tek bir kullanışlı adımda bağlanmanıza olanak tanır.

IPv6 etkinleştirilirse ve TcpClient(String, Int32) yöntemi hem IPv6 hem de IPv4 adreslerine çözümlenen bir konağa bağlanmak için çağrılırsa, önce IPv4 adresinden önce IPv6 adresiyle bağlantı denenecektir. Bu, ana bilgisayar IPv6 adresinde dinlemiyorsa bağlantı kurma süresini geciktirme etkisine sahip olabilir.

Not

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı bir açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için .NET Framework ağ izleme bölümüne bakın.

Ayrıca bkz.

• TcpClient
• Connect(String, Int32)