SendMailErrorEventArgs.Handled Properti
Definisi
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.
Menunjukkan apakah pengecualian SMTP yang terkandung dalam properti telah ditangani Exception .
public:
property bool Handled { bool get(); void set(bool value); };
public bool Handled { get; set; }
member this.Handled : bool with get, set
Public Property Handled As Boolean
Nilai Properti
Jika true, pengecualian dikonsumsi dan ditangani SendMailErrorEventHandler oleh delegasi. Jika false, pengecualian ditumbuhi kembali, termasuk tumpukan panggilan asli dan pesan kesalahan.
Defaultnya adalah false.
Keterangan
Properti Handled menunjukkan apakah telah ditangani Exception . Pengecualian dimunculkan oleh penyedia email SMTP ketika pesan email tidak dapat dikirim oleh ChangePassword kontrol atau CreateUserWizard. Alasan paling umum untuk pengecualian adalah kesalahan konfigurasi di <Elemen smtp> (Pengaturan Jaringan) dari file konfigurasi komputer. Meskipun kesalahan seperti ini biasanya ditemukan selama pengembangan dan penelusuran kesalahan aplikasi, server email dapat gagal secara tak terduga di lingkungan produksi, dan Anda harus menentukan apakah Anda ingin seluruh aplikasi gagal dalam situasi tersebut. Jika tidak, menangani peristiwa memungkinkan aplikasi Anda untuk melanjutkan.
Jika Anda tidak membuat penanganan aktivitas untuk peristiwa tersebut SendMailError , atau jika Anda membuat penanganan aktivitas tetapi membiarkan Handled properti diatur ke false, aplikasi Web Anda akan berhenti berjalan jika terjadi kesalahan saat mengirim pesan email, dan ASP.NET akan menampilkan pesan kesalahan. Menangani peristiwa memungkinkan aplikasi Web Anda untuk terus berjalan meskipun telah terjadi pengecualian. Ini berguna ketika tidak penting untuk mengirim pesan email. Misalnya, jika pengecualian terjadi saat pengguna bekerja melalui wizard multi-langkah, sebaiknya catat kesalahan, tampilkan pesan informatif kepada pengguna, dan izinkan pengguna menyelesaikan wizard.