TcpClient.ConnectAsync Yöntem

Tanım

Ad Alanı:: System.Net.Sockets

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Net.Sockets.dll

Bütünleştirilmiş Kod:: System.Net.Sockets.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen ana bilgisayar adını ve bağlantı noktası numarasını zaman uyumsuz bir işlem olarak kullanarak istemciyi uzak bir TCP konağına bağlar.

Aşırı Yüklemeler

Name	Description
ConnectAsync(String, Int32, CancellationToken)	İstemciyi, zaman uyumsuz bir işlem olarak belirtilen konakta belirtilen TCP bağlantı noktasına bağlar.
ConnectAsync(IPAddress[], Int32, CancellationToken)	Belirtilen IP adreslerini ve bağlantı noktası numarasını zaman uyumsuz bir işlem olarak kullanarak istemciyi uzak bir TCP konağına bağlar.
ConnectAsync(IPAddress, Int32, CancellationToken)	Belirtilen IP adresini ve bağlantı noktası numarasını zaman uyumsuz bir işlem olarak kullanarak istemciyi uzak bir TCP konağına bağlar.
ConnectAsync(String, Int32)	İstemciyi, zaman uyumsuz bir işlem olarak belirtilen konakta belirtilen TCP bağlantı noktasına bağlar.
ConnectAsync(IPEndPoint, CancellationToken)	Zaman uyumsuz bir işlem olarak belirtilen uç noktayı kullanarak istemciyi uzak bir TCP konağına bağlar.
ConnectAsync(IPAddress[], Int32)	Belirtilen IP adreslerini ve bağlantı noktası numarasını zaman uyumsuz bir işlem olarak kullanarak istemciyi uzak bir TCP konağına bağlar.
ConnectAsync(IPAddress, Int32)	Belirtilen IP adresini ve bağlantı noktası numarasını zaman uyumsuz bir işlem olarak kullanarak istemciyi uzak bir TCP konağına bağlar.
ConnectAsync(IPEndPoint)	Zaman uyumsuz bir işlem olarak belirtilen uç noktayı kullanarak istemciyi uzak bir TCP konağına bağlar.

ConnectAsync(String, Int32, CancellationToken)

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

İstemciyi, zaman uyumsuz bir işlem olarak belirtilen konakta belirtilen TCP bağlantı noktasına bağlar.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync(string host, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parametreler

host: String

Uzak ana bilgisayarın DNS adı.

port: Int32

Uzak konağın bağlantı noktası numarası.

cancellationToken: CancellationToken

Zaman uyumsuz işlemin iptal edilmesi gerektiğini belirten bir iptal belirteci.

Döndürülenler

ValueTask

Zaman uyumsuz bağlantı işlemini temsil eden bir görev.

Özel durumlar

ArgumentNullException

host parametresi null'dir.

ArgumentOutOfRangeException

port parametresi ile MinPortarasında MaxPort değil.

SocketException

Yuvaya erişilirken bir hata oluştu.

ObjectDisposedException

TcpClient kapalıdır.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu işlem engellenmez. Döndürülen görev, TCP bağlantısı kurulduktan sonra tamamlanır. Bu yöntem, bağlantı isteği devam ederken çağıran iş parçacığını engellemez.

Belirtilen ana bilgisayar adına ve bağlantı noktası numarasına zaman uyumsuz işlem olarak zaman uyumlu bir uzak konak bağlantısı kurmak için bu yöntemi çağırın. Uzak ana bilgisayarla bağlandıktan sonra, temel alınan GetStreamöğesini elde etmek için yöntemini kullanınNetworkStream. Veri göndermek ve almak için bunu NetworkStream kullanın.

IPv6 etkinse ve ConnectAsync(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.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Connect(String, Int32)oluşan özel durumlara bakın.

Ayrıca bkz.

Şunlara uygulanır

ConnectAsync(IPAddress[], Int32, CancellationToken)

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Belirtilen IP adreslerini ve bağlantı noktası numarasını zaman uyumsuz bir işlem olarak kullanarak istemciyi uzak bir TCP konağına bağlar.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync(System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

Parametreler

addresses: IPAddress[]

Uzak konağın IP adresi dizisi.

port: Int32

Uzak konağın bağlantı noktası numarası.

cancellationToken: CancellationToken

Zaman uyumsuz işlemin iptal edilmesi gerektiğini belirten bir iptal belirteci.

Döndürülenler

ValueTask

Zaman uyumsuz bağlantı işlemini temsil eden bir görev.

Özel durumlar

ArgumentNullException

addresses parametresi null'dir.

ArgumentOutOfRangeException

Bağlantı noktası numarası geçerli değil.

SocketException

Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Kapatılmış Socket .

SecurityException

Çağrı yığınında daha yüksek bir çağıranın istenen işlem için izni yok.

NotSupportedException

Bu yöntem, bayrağını veya InterNetwork bayrağını InterNetworkV6 kullanan yuvalar için geçerlidir.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu işlem engellenmez. Döndürülen görev, TCP bağlantısı kurulduktan sonra tamamlanır. Bu yöntem, bağlantı isteği devam ederken çağıran iş parçacığını engellemez.

Bu yöntem genellikle tek bir konak için birden çok IP adresi döndürebilen yöntem çağrısından BeginGetHostAddresses hemen sonra kullanılır. IP adresleri dizisi ve bağlantı noktası numarası tarafından zaman uyumsuz işlem olarak belirtilen konağa zaman uyumlu bir uzak konak bağlantısı kurmak için bu yöntemi çağırın. Uzak ana bilgisayarla bağlandıktan sonra, temel alınan GetStreamöğesini elde etmek için yöntemini kullanınNetworkStream. Veri göndermek ve almak için bunu NetworkStream kullanın.

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.

Note

IPv6 adresini kullanırken notSupportedException iletisini This protocol version is not supported alıyorsanız, geçirerek oluşturucuda IPv6'yı etkinleştirdiğinizden InterNetworkV6emin olun.

Ayrıca bkz.

TcpListener

Şunlara uygulanır

ConnectAsync(IPAddress, Int32, CancellationToken)

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Belirtilen IP adresini ve bağlantı noktası numarasını zaman uyumsuz bir işlem olarak kullanarak istemciyi uzak bir TCP konağına bağlar.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync(System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parametreler

address: IPAddress

Uzak konağın IP adresi.

port: Int32

Uzak konağın bağlantı noktası numarası.

cancellationToken: CancellationToken

Zaman uyumsuz işlemin iptal edilmesi gerektiğini belirten bir iptal belirteci.

Döndürülenler

ValueTask

Zaman uyumsuz bağlantı işlemini temsil eden bir görev.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

ArgumentOutOfRangeException

port ve arasında MinPort MaxPortdeğildir.

SocketException

Yuvaya erişilirken bir hata oluştu.

ObjectDisposedException

TcpClient kapalıdır.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu işlem engellenmez. Döndürülen görev, TCP bağlantısı kurulduktan sonra tamamlanır. Bu yöntem, bağlantı isteği devam ederken çağıran iş parçacığını engellemez.

Belirtilen IP adresine ve bağlantı noktası numarasına zaman uyumsuz işlem olarak zaman uyumlu bir uzak konak bağlantısı kurmak için bu yöntemi çağırın. Uzak ana bilgisayarla bağlandıktan sonra, temel alınan GetStreamöğesini elde etmek için yöntemini kullanınNetworkStream. Veri göndermek ve almak için bunu NetworkStream kullanın.

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.

Note

IPv6 adresini kullanırken notSupportedException iletisini This protocol version is not supported alıyorsanız, geçirerek oluşturucuda IPv6'yı etkinleştirdiğinizden InterNetworkV6emin olun.

Ayrıca bkz.

GetStream()

Şunlara uygulanır

ConnectAsync(String, Int32)

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

İstemciyi, zaman uyumsuz bir işlem olarak belirtilen konakta belirtilen TCP bağlantı noktasına bağlar.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);

public System.Threading.Tasks.Task ConnectAsync(string host, int port);

member this.ConnectAsync : string * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (host As String, port As Integer) As Task

Parametreler

host: String

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

port: Int32

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

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

host parametresi null'dir.

ArgumentOutOfRangeException

port parametresi ile MinPortarasında MaxPort değil.

SocketException

Yuvaya erişilirken bir hata oluştu.

ObjectDisposedException

TcpClient kapalıdır.

Açıklamalar

Bu işlem engellenmez. Döndürülen Returns Task nesnesi, TCP bağlantısı kurulduktan sonra tamamlanır. Bu yöntem, bağlantı isteği devam ederken çağıran iş parçacığını engellemez.

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.

Şunlara uygulanır

ConnectAsync(IPEndPoint, CancellationToken)

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Zaman uyumsuz bir işlem olarak belirtilen uç noktayı kullanarak istemciyi uzak bir TCP konağına bağlar.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPEndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync(System.Net.IPEndPoint remoteEP, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTask

Parametreler

remoteEP: IPEndPoint

IPEndPoint Bağlanmak istediğiniz.

cancellationToken: CancellationToken

Bu işlemin iptal edilmesi gerektiğine ilişkin bildirimi yaymak için kullanılan bir iptal belirteci.

Döndürülenler

ValueTask

Zaman uyumsuz işlemi temsil eden bir görev.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu işlem engellenmez. Döndürülen Returns Task nesnesi, TCP bağlantısı kurulduktan sonra tamamlanır. Bu yöntem, bağlantı isteği devam ederken çağıran iş parçacığını engellemez.

Belirtilen IPEndPointöğesine zaman uyumlu bir uzak konak bağlantısı kurmak için bu yöntemi çağırın. çağrısından Connectönce, IP adresi ve bağlantı noktası numarası kullanarak sınıfın IPEndPoint bir örneğini oluşturmanız gerekir. Bunu IPEndPoint parametre olarak remoteEP kullanın. yöntemi Connect , bağlanana veya başarısız olana kadar engeller. Uzak ana bilgisayarla bağlandıktan sonra, temel alınan GetStreamöğesini elde etmek için yöntemini kullanınNetworkStream. Veri göndermek ve almak için bunu NetworkStream kullanın.

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.

Note

IPv6 adresini kullanırken notSupportedException iletisini This protocol version is not supported alıyorsanız, geçirerek oluşturucuda IPv6'yı etkinleştirdiğinizden InterNetworkV6emin olun.

Şunlara uygulanır

ConnectAsync(IPAddress[], Int32)

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Belirtilen IP adreslerini ve bağlantı noktası numarasını zaman uyumsuz bir işlem olarak kullanarak istemciyi uzak bir TCP konağına bağlar.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);

public System.Threading.Tasks.Task ConnectAsync(System.Net.IPAddress[] addresses, int port);

member this.ConnectAsync : System.Net.IPAddress[] * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task

Parametreler

addresses: IPAddress[]

IPAddress Bağlanmak istediğiniz konağın dizisi.

port: Int32

Bağlanmak istediğiniz bağlantı noktası numarası.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

addresses parametresi null'dir.

ArgumentOutOfRangeException

Bağlantı noktası numarası geçerli değil.

SocketException

Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Kapatılmış Socket .

SecurityException

Çağrı yığınında daha yüksek bir çağıranın istenen işlem için izni yok.

NotSupportedException

Bu yöntem, bayrağını veya InterNetwork bayrağını InterNetworkV6 kullanan yuvalar için geçerlidir.

Açıklamalar

Bu işlem engellenmez. Döndürülen Returns Task nesnesi, TCP bağlantısı kurulduktan sonra tamamlanır. Bu yöntem, bağlantı isteği devam ederken çağıran iş parçacığını engellemez.

Bu yöntem genellikle tek bir konak için birden çok IP adresi döndürebilen yöntem çağrısından BeginGetHostAddresses hemen sonra kullanılır. Öğe dizisi IPAddress ve bağlantı noktası numarası tarafından zaman uyumsuz bir işlem olarak belirtilen konağa zaman uyumlu bir uzak konak bağlantısı kurmak için bu yöntemi çağırın. Uzak ana bilgisayarla bağlandıktan sonra, temel alınan GetStreamöğesini elde etmek için yöntemini kullanınNetworkStream. Veri göndermek ve almak için bunu NetworkStream kullanın.

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.

Note

IPv6 adresini kullanırken notSupportedException iletisini This protocol version is not supported alıyorsanız, geçirerek oluşturucuda IPv6'yı etkinleştirdiğinizden InterNetworkV6emin olun.

Ayrıca bkz.

TcpListener

Şunlara uygulanır

ConnectAsync(IPAddress, Int32)

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Belirtilen IP adresini ve bağlantı noktası numarasını zaman uyumsuz bir işlem olarak kullanarak istemciyi uzak bir TCP konağına bağlar.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);

public System.Threading.Tasks.Task ConnectAsync(System.Net.IPAddress address, int port);

member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (address As IPAddress, port As Integer) As Task

Parametreler

address: IPAddress

IPAddress Bağlanmak istediğiniz konağın.

port: Int32

Bağlanmak istediğiniz bağlantı noktası numarası.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

ArgumentOutOfRangeException

port ve arasında MinPort MaxPortdeğildir.

SocketException

Yuvaya erişilirken bir hata oluştu.

ObjectDisposedException

TcpClient kapalıdır.

Açıklamalar

Bu işlem engellenmez. Döndürülen Returns Task nesnesi, TCP bağlantısı kurulduktan sonra tamamlanır. Bu yöntem, bağlantı isteği devam ederken çağıran iş parçacığını engellemez.

Belirtilen IPAddress ve bağlantı noktası numarasına zaman uyumsuz işlem olarak zaman uyumlu bir uzak konak bağlantısı kurmak için bu yöntemi çağırın. Uzak ana bilgisayarla bağlandıktan sonra, temel alınan GetStreamöğesini elde etmek için yöntemini kullanınNetworkStream. Veri göndermek ve almak için bunu NetworkStream kullanın.

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.

Note

IPv6 adresini kullanırken notSupportedException iletisini This protocol version is not supported alıyorsanız, geçirerek oluşturucuda IPv6'yı etkinleştirdiğinizden InterNetworkV6emin olun.

Ayrıca bkz.

GetStream()

Şunlara uygulanır

ConnectAsync(IPEndPoint)

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Kaynak:: TCPClient.cs

Zaman uyumsuz bir işlem olarak belirtilen uç noktayı kullanarak istemciyi uzak bir TCP konağına bağlar.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPEndPoint ^ remoteEP);

public System.Threading.Tasks.Task ConnectAsync(System.Net.IPEndPoint remoteEP);

member this.ConnectAsync : System.Net.IPEndPoint -> System.Threading.Tasks.Task

Public Function ConnectAsync (remoteEP As IPEndPoint) As Task

Parametreler

remoteEP: IPEndPoint

IPEndPoint Bağlanmak istediğiniz.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden bir görev.

Açıklamalar

Bu işlem engellenmez. Döndürülen Task nesne, TCP bağlantısı kurulduktan sonra tamamlanır. Bu yöntem, bağlantı isteği devam ederken çağıran iş parçacığını engellemez.

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 Yuva 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.

Note

IPv6 adresini kullanırken "Bu protokol sürümü desteklenmiyor" iletisiyle bir alırsanız NotSupportedException , geçirerek InterNetworkV6oluşturucuda IPv6'yı etkinleştirdiğinizden emin olun.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?