Socket.EndSendFile(IAsyncResult) Metode

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

System.Net.Sockets.dll

Sumber:

Socket.cs

Mengakhiri pengiriman file asinkron yang tertunda.

public:
 void EndSendFile(IAsyncResult ^ asyncResult);

public void EndSendFile (IAsyncResult asyncResult);

member this.EndSendFile : IAsyncResult -> unit

Public Sub EndSendFile (asyncResult As IAsyncResult)

Parameter

asyncResult

IAsyncResult

Objek IAsyncResult yang menyimpan informasi status untuk operasi asinkron ini.

Pengecualian

NotSupportedException

Hanya .NET 8+: Soket tidak terhubung ke host jarak jauh.

ObjectDisposedException

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

ArgumentNullException

asyncResult kosong.

ArgumentException

asyncResult tidak dikembalikan oleh panggilan ke BeginSendFile(String, AsyncCallback, Object) metode .

InvalidOperationException

EndSendFile(IAsyncResult) sebelumnya dipanggil untuk asinkron BeginSendFile(String, AsyncCallback, Object).

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

-atau-

Hanya .NET 7+: 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.

EndSendFile menyelesaikan operasi yang dimulai oleh BeginSend. Anda perlu meneruskan yang IAsyncResult dibuat oleh panggilan yang BeginSend cocok.

Jika Anda menggunakan protokol tanpa koneksi, EndSendFile blokir hingga datagram dikirim. Jika Anda menggunakan protokol berorientasi koneksi, EndSendFile blokir hingga seluruh file dikirim. Tidak ada jaminan bahwa data yang Anda kirim akan segera muncul di jaringan. Untuk meningkatkan efisiensi jaringan, sistem yang mendasar dapat menunda transmisi hingga sejumlah besar data keluar dikumpulkan. Penyelesaian metode yang BeginSendFile berhasil berarti bahwa sistem yang mendasar telah memiliki ruang untuk buffer data Anda untuk pengiriman jaringan.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode properti untuk mendapatkan kode kesalahan tertentu. Setelah Anda mendapatkan kode ini, lihat 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.