Bagikan melalui

SendMailErrorEventArgs Kelas

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Menyediakan data untuk SendMailError peristiwa kontrol seperti ChangePassword kontrol, CreateUserWizard kontrol, dan PasswordRecovery kontrol.

public ref class SendMailErrorEventArgs : EventArgs
public class SendMailErrorEventArgs : EventArgs
type SendMailErrorEventArgs = class
    inherit EventArgs
Public Class SendMailErrorEventArgs
Inherits EventArgs
Warisan
Object
EventArgs
SendMailErrorEventArgs

Keterangan

Objek SendMailErrorEventArgs berisi pesan kesalahan yang dimunculkan oleh penyedia email SMTP ketika pesan email tidak dapat dikirim oleh ChangePassword kontrol, atau CreateUserWizard kontrol. Dalam kasus seperti itu SendMailErrorEventArgs , objek dikirim ke SendMailErrorEventHandler.

Buat SendMailErrorEventHandler delegasi untuk menangani peristiwa. 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.

Exception Periksa properti untuk menentukan penyebab sebenarnya pengecualian. 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.

Anda harus mengatur Handled properti ke untuk true memberi sinyal bahwa pengecualian telah ditangani; jika tidak, pengecualian ditumbuhi kembali, dan akan menyertakan tumpukan panggilan asli dan pesan kesalahan.

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.

Metode ini OnSendMailError juga memungkinkan kelas turunan untuk menangani peristiwa, alih-alih ini dilakukan oleh SendMailErrorEventHandler. Ini adalah teknik yang disukai untuk menangani peristiwa di kelas yang berasal dari ChangePassword atau CreateUserWizard.

Untuk informasi selengkapnya tentang menangani peristiwa, lihat Penanganan Peristiwa Server di Halaman Formulir Web ASP.NET.

Catatan Bagi Inheritor

Saat mengambil alih kelas turunan OnSendMailError(SendMailErrorEventArgs) , pastikan untuk memanggil OnSendMailError(SendMailErrorEventArgs) metode kelas dasar untuk mengaktifkan delegasi terdaftar untuk menerima peristiwa.

Konstruktor

Nama Deskripsi
SendMailErrorEventArgs(Exception)

Menginisialisasi instans baru dari kelas SendMailErrorEventArgs.

Properti

Nama Deskripsi
Exception

Mengembalikan pengecualian yang dilemparkan oleh layanan email SMTP saat pesan email tidak dapat dikirim.
Handled

Menunjukkan apakah pengecualian SMTP yang terkandung dalam properti telah ditangani Exception .

Metode

Nama Deskripsi
Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Berlaku untuk

Lihat juga