TcpClient Oluşturucular

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Sockets.dll

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

Aşırı Yüklemeler

Name	Description
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 = 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önderip almadan önce yöntemini çağırmalısınız Connect .

Note

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

Note

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework Ağ İzleme.

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 parametresi null'dir.

Örnekler

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

//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öndermek ve 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 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ğırmalısınız Connect .

Note

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework Ağ İzleme.

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 = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Açıklamalar

Note

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework Ağ İzleme.

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 parametresi null'dir.

ArgumentOutOfRangeException

port parametresi ile MinPortarasında MaxPort 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 TcpClient bir örneğinin nasıl oluşturulacağını gösterir.

//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ğlanana 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 etkinse 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 adresini dinlemiyorsa bağlantı kurma süresini geciktirme etkisine neden olabilir.

Note

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ı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

Note

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework Ağ İzleme.

Ayrıca bkz.

• TcpClient
• Connect(String, Int32)