Socket.EndReceiveFrom(IAsyncResult, EndPoint) Metode

Referensi

Definisi

Ruang nama:: System.Net.Sockets

Rakitan:: System.Net.Sockets.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Sumber:: Socket.cs

Sumber:: Socket.cs

Sumber:: Socket.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengakhiri pembacaan asinkron yang tertunda dari titik akhir tertentu.

public:
 int EndReceiveFrom(IAsyncResult ^ asyncResult, System::Net::EndPoint ^ % endPoint);

public int EndReceiveFrom (IAsyncResult asyncResult, ref System.Net.EndPoint endPoint);

member this.EndReceiveFrom : IAsyncResult * EndPoint -> int

Public Function EndReceiveFrom (asyncResult As IAsyncResult, ByRef endPoint As EndPoint) As Integer

Parameter

asyncResult: IAsyncResult

Yang IAsyncResult menyimpan informasi status dan data yang ditentukan pengguna untuk operasi asinkron ini.

endPoint: EndPoint

Sumber EndPoint.

Mengembalikan

Int32

Jika berhasil, jumlah byte yang diterima. Jika tidak berhasil, mengembalikan 0.

Pengecualian

ArgumentNullException

asyncResultadalah null.

ArgumentException

asyncResult tidak dikembalikan oleh panggilan ke BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object) metode .

InvalidOperationException

EndReceiveFrom(IAsyncResult, EndPoint) sebelumnya dipanggil untuk pembacaan asinkron.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

-atau-

Hanya .NET 7+: Socket telah ditutup.

ObjectDisposedException

.NET Framework, .NET Core, dan .NET 5-6 saja: Socket telah ditutup.

Keterangan

Penting

Ini adalah API kompatibilitas. Kami tidak merekomendasikan penggunaan metode APM (Begin* dan End*) untuk pengembangan baru. Sebagai gantinya Task, gunakan setara berbasis.

EndReceiveFrom menyelesaikan operasi yang dimulai oleh BeginReceiveFrom. Anda perlu meneruskan yang IAsyncResult dibuat oleh panggilan yang BeginReceiveFrom cocok.

Metode EndReceiveFrom ini akan memblokir hingga data tersedia. Jika Anda menggunakan protokol tanpa koneksi, EndReceiveFrom akan membaca datagram antrean pertama yang tersedia di buffer jaringan masuk. Jika Anda menggunakan protokol berorientasi koneksi, EndReceiveFrom metode akan membaca data sebanyak yang tersedia hingga jumlah byte yang Anda tentukan dalam size parameter BeginReceiveFrom metode . Jika host jarak jauh mematikan Socket koneksi dengan Shutdown metode , dan semua data yang tersedia telah diterima, EndReceiveFrom metode akan segera selesai dan mengembalikan nol byte. Untuk mendapatkan data yang diterima, panggil AsyncState metode IAsyncResult objek , dan ekstrak buffer yang terkandung dalam objek status yang dihasilkan. Untuk mengidentifikasi host asal, ekstrak EndPoint dan transmisikan ke IPEndPoint. IPEndPoint.Address Gunakan metode untuk mendapatkan alamat IP dan IPEndPoint.Port metode untuk mendapatkan nomor port.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode properti untuk mendapatkan kode kesalahan tertentu.

Catatan

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

Berlaku untuk

Bagikan melalui