TcpClient.ConnectAsync Metode

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

System.Net.Sockets.dll

Menyambungkan klien ke host TCP jarak jauh menggunakan nama host dan nomor port yang ditentukan sebagai operasi asinkron.

Overload

ConnectAsync(String, Int32, CancellationToken)	Menyambungkan klien ke port TCP yang ditentukan pada host yang ditentukan sebagai operasi asinkron.
ConnectAsync(IPAddress[], Int32, CancellationToken)	Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan sebagai operasi asinkron.
ConnectAsync(IPAddress, Int32, CancellationToken)	Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan sebagai operasi asinkron.
ConnectAsync(String, Int32)	Menyambungkan klien ke port TCP yang ditentukan pada host yang ditentukan sebagai operasi asinkron.
ConnectAsync(IPEndPoint, CancellationToken)	Menyambungkan klien ke host TCP jarak jauh menggunakan titik akhir yang ditentukan sebagai operasi asinkron.
ConnectAsync(IPAddress[], Int32)	Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan sebagai operasi asinkron.
ConnectAsync(IPAddress, Int32)	Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan sebagai operasi asinkron.
ConnectAsync(IPEndPoint)	Menyambungkan klien ke host TCP jarak jauh menggunakan titik akhir yang ditentukan sebagai operasi asinkron.

ConnectAsync(String, Int32, CancellationToken)

Sumber:

TCPClient.cs

Menyambungkan klien ke port TCP yang ditentukan pada host yang ditentukan sebagai operasi asinkron.

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

Parameter

host

String

Nama DNS host jarak jauh.

port

Int32

Nomor port host jarak jauh.

cancellationToken

CancellationToken

Token pembatalan yang dapat digunakan untuk memberi sinyal operasi asinkron harus dibatalkan.

Mengembalikan

ValueTask

Tugas yang mewakili operasi koneksi asinkron.

Pengecualian

ArgumentNullException

Parameternya host adalah null.

ArgumentOutOfRangeException

Parameter port bukan antara MinPort dan MaxPort.

SocketException

Terjadi kesalahan saat mengakses soket.

ObjectDisposedException

TcpClient ditutup.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Operasi ini tidak akan memblokir. Tugas yang dikembalikan akan selesai setelah koneksi TCP dibuat. Metode ini tidak memblokir utas panggilan saat permintaan koneksi sedang berlangsung.

Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke nama host dan nomor port yang ditentukan sebagai operasi asinkron. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Jika IPv6 diaktifkan dan ConnectAsync(String, Int32) metode dipanggil untuk terhubung ke host yang diselesaikan ke alamat IPv6 dan IPv4, koneksi ke alamat IPv6 akan dicoba terlebih dahulu sebelum alamat IPv4. Ini mungkin memiliki efek menunda waktu untuk membuat koneksi jika host tidak mendengarkan alamat IPv6.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Connect(String, Int32).

Lihat juga

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPAddress[], Int32, CancellationToken)

Sumber:

TCPClient.cs

Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan sebagai operasi asinkron.

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

Parameter

addresses

IPAddress[]

Array alamat IP host jarak jauh.

port

Int32

Nomor port host jarak jauh.

cancellationToken

CancellationToken

Token pembatalan yang dapat digunakan untuk memberi sinyal operasi asinkron harus dibatalkan.

Mengembalikan

ValueTask

Tugas yang mewakili operasi koneksi asinkron.

Pengecualian

ArgumentNullException

Parameternya ipAddresses adalah null.

ArgumentOutOfRangeException

Nomor port tidak valid.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

ObjectDisposedException

Sudah Socket ditutup.

SecurityException

Penelepon yang lebih tinggi dalam tumpukan panggilan tidak memiliki izin untuk operasi yang diminta.

NotSupportedException

Metode ini berlaku untuk soket yang menggunakan InterNetwork bendera atau InterNetworkV6 bendera .

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Operasi ini tidak akan memblokir. Tugas yang dikembalikan akan selesai setelah koneksi TCP dibuat. Metode ini tidak memblokir utas panggilan saat permintaan koneksi sedang berlangsung.

Metode ini biasanya digunakan segera setelah panggilan ke BeginGetHostAddresses metode , yang dapat mengembalikan beberapa alamat IP untuk satu host. Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke host yang ditentukan oleh array alamat IP dan nomor port sebagai operasi asinkron. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Catatan

Jika Anda menerima NotSupportedException dengan pesan This protocol version is not supported saat menggunakan alamat IPv6, pastikan Anda mengaktifkan IPv6 di konstruktor dengan meneruskan InterNetworkV6.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Connect(IPAddress[], Int32).

Lihat juga

• TcpListener

ConnectAsync(IPAddress, Int32, CancellationToken)

Sumber:

TCPClient.cs

Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan sebagai operasi asinkron.

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

Parameter

address

IPAddress

Alamat IP host jarak jauh.

port

Int32

Nomor port host jarak jauh.

cancellationToken

CancellationToken

Token pembatalan yang dapat digunakan untuk memberi sinyal operasi asinkron harus dibatalkan.

Mengembalikan

ValueTask

Tugas yang mewakili operasi koneksi asinkron.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

ArgumentOutOfRangeException

port bukan antara MinPort dan MaxPort.

SocketException

Terjadi kesalahan saat mengakses soket.

ObjectDisposedException

TcpClient ditutup.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Operasi ini tidak akan memblokir. Tugas yang dikembalikan akan selesai setelah koneksi TCP dibuat. Metode ini tidak memblokir utas panggilan saat permintaan koneksi sedang berlangsung.

Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke alamat IP dan nomor port yang ditentukan sebagai operasi asinkron. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Catatan

Jika Anda menerima NotSupportedException dengan pesan This protocol version is not supported saat menggunakan alamat IPv6, pastikan Anda mengaktifkan IPv6 di konstruktor dengan meneruskan InterNetworkV6.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Connect(IPAddress, Int32).

Lihat juga

• GetStream()

ConnectAsync(String, Int32)

Sumber:

TCPClient.cs

Menyambungkan klien ke port TCP yang ditentukan pada host yang ditentukan sebagai operasi asinkron.

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

Parameter

host

String

Nama DNS host jarak jauh yang ingin Anda sambungkan.

port

Int32

Nomor port host jarak jauh yang ingin Anda sambungkan.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

Parameternya host adalah null.

ArgumentOutOfRangeException

Parameter port bukan antara MinPort dan MaxPort.

SocketException

Terjadi kesalahan saat mengakses soket.

ObjectDisposedException

TcpClient ditutup.

Keterangan

Operasi ini tidak akan memblokir. Objek Pengembalian yang Task dikembalikan akan selesai setelah koneksi TCP dibuat. Metode ini tidak memblokir utas panggilan saat permintaan koneksi sedang berlangsung.

Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke nama host dan nomor port yang ditentukan sebagai operasi asinkron. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Jika IPv6 diaktifkan dan ConnectAsync(String, Int32) metode dipanggil untuk terhubung ke host yang diselesaikan ke alamat IPv6 dan IPv4, koneksi ke alamat IPv6 akan dicoba terlebih dahulu sebelum alamat IPv4. Ini mungkin memiliki efek menunda waktu untuk membuat koneksi jika host tidak mendengarkan alamat IPv6.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Connect(String, Int32).

Lihat juga

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPEndPoint, CancellationToken)

Sumber:

TCPClient.cs

Menyambungkan klien ke host TCP jarak jauh menggunakan titik akhir yang ditentukan sebagai operasi asinkron.

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

Parameter

remoteEP

IPEndPoint

yang IPEndPoint ingin Anda sambungkan.

cancellationToken

CancellationToken

Token pembatalan yang digunakan untuk menyebarluaskan pemberitahuan bahwa operasi ini harus dibatalkan.

Mengembalikan

ValueTask

Tugas yang mewakili operasi asinkron.

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Operasi ini tidak akan memblokir. Objek Pengembalian yang Task dikembalikan akan selesai setelah koneksi TCP dibuat. Metode ini tidak memblokir utas panggilan saat permintaan koneksi sedang berlangsung.

Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke yang ditentukan IPEndPoint. Sebelum memanggil Connect, Anda harus membuat instans IPEndPoint kelas menggunakan alamat IP dan nomor port. Gunakan ini IPEndPoint sebagai remoteEP parameter . Metode Connect ini akan memblokir hingga tersambung atau gagal. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Catatan

Jika Anda menerima NotSupportedException dengan pesan This protocol version is not supported saat menggunakan alamat IPv6, pastikan Anda mengaktifkan IPv6 di konstruktor dengan meneruskan InterNetworkV6.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Connect(IPEndPoint).

ConnectAsync(IPAddress[], Int32)

Sumber:

TCPClient.cs

Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan sebagai operasi asinkron.

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

Parameter

addresses

IPAddress[]

Array IPAddress host yang ingin Anda sambungkan.

port

Int32

Nomor port yang ingin Anda sambungkan.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

Parameternya ipAddresses adalah null.

ArgumentOutOfRangeException

Nomor port tidak valid.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

ObjectDisposedException

Sudah Socket ditutup.

SecurityException

Penelepon yang lebih tinggi dalam tumpukan panggilan tidak memiliki izin untuk operasi yang diminta.

NotSupportedException

Metode ini berlaku untuk soket yang menggunakan InterNetwork bendera atau InterNetworkV6 bendera .

Keterangan

Operasi ini tidak akan memblokir. Objek Pengembalian yang Task dikembalikan akan selesai setelah koneksi TCP dibuat. Metode ini tidak memblokir utas panggilan saat permintaan koneksi sedang berlangsung.

Metode ini biasanya digunakan segera setelah panggilan ke BeginGetHostAddresses metode , yang dapat mengembalikan beberapa alamat IP untuk satu host. Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke host yang ditentukan oleh array IPAddress elemen dan nomor port sebagai operasi asinkron. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Catatan

Jika Anda menerima NotSupportedException dengan pesan This protocol version is not supported saat menggunakan alamat IPv6, pastikan Anda mengaktifkan IPv6 di konstruktor dengan meneruskan InterNetworkV6.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Connect(IPAddress[], Int32).

Lihat juga

• TcpListener

ConnectAsync(IPAddress, Int32)

Sumber:

TCPClient.cs

Menyambungkan klien ke host TCP jarak jauh menggunakan alamat IP dan nomor port yang ditentukan sebagai operasi asinkron.

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

Parameter

address

IPAddress

Host IPAddress yang ingin Anda sambungkan.

port

Int32

Nomor port yang ingin Anda sambungkan.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

ArgumentOutOfRangeException

port bukan antara MinPort dan MaxPort.

SocketException

Terjadi kesalahan saat mengakses soket.

ObjectDisposedException

TcpClient ditutup.

Keterangan

Operasi ini tidak akan memblokir. Objek Pengembalian yang Task dikembalikan akan selesai setelah koneksi TCP dibuat. Metode ini tidak memblokir utas panggilan saat permintaan koneksi sedang berlangsung.

Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke nomor port yang ditentukan IPAddress sebagai operasi asinkron. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah Anda mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Catatan

Jika Anda menerima NotSupportedException dengan pesan This protocol version is not supported saat menggunakan alamat IPv6, pastikan Anda mengaktifkan IPv6 di konstruktor dengan meneruskan InterNetworkV6.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Connect(IPAddress, Int32).

Lihat juga

• GetStream()

ConnectAsync(IPEndPoint)

Sumber:

TCPClient.cs

Menyambungkan klien ke host TCP jarak jauh menggunakan titik akhir yang ditentukan sebagai operasi asinkron.

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

Parameter

remoteEP

IPEndPoint

yang IPEndPoint ingin Anda sambungkan.

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task akan selesai setelah koneksi TCP dibuat. Metode ini tidak memblokir utas panggilan saat permintaan koneksi sedang berlangsung.

Panggil metode ini untuk membuat koneksi host jarak jauh sinkron ke yang ditentukan IPEndPoint. Sebelum memanggil Connect, Anda harus membuat instans IPEndPoint kelas menggunakan alamat IP dan nomor port. Gunakan ini IPEndPoint sebagai remoteEP parameter . Metode ini Connect akan memblokir hingga tersambung atau gagal. Setelah terhubung dengan host jarak jauh, gunakan GetStream metode untuk mendapatkan yang mendasar NetworkStream. Gunakan ini NetworkStream untuk mengirim dan menerima data.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan WINDOWS Sockets versi 2 API untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Catatan

Jika Anda menerima NotSupportedException dengan pesan "Versi protokol ini tidak didukung" saat menggunakan alamat IPv6, pastikan Anda mengaktifkan IPv6 di konstruktor dengan melewati InterNetworkV6.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Connect(IPEndPoint).