SendMailErrorEventArgs Kelas
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.
Menyediakan data untuk SendMailError peristiwa kontrol seperti ChangePassword kontrol, CreateUserWizard kontrol, dan PasswordRecovery kontrol.
public ref class SendMailErrorEventArgs : EventArgspublic class SendMailErrorEventArgs : EventArgstype SendMailErrorEventArgs = class
inherit EventArgsPublic Class SendMailErrorEventArgs
Inherits EventArgs- Warisan
Contoh
Contoh kode berikut menunjukkan halaman ASP.NET yang menggunakan ChangePassword kontrol Web, dan menyertakan penanganan aktivitas untuk SendMailError peristiwa bernama SendMailError. Contoh kode mengasumsikan bahwa situs Web ASP.NET telah dikonfigurasi untuk menggunakan keanggotaan ASP.NET dan autentikasi Formulir, dan bahwa pengguna telah dibuat yang nama dan kata sandinya diketahui oleh Anda. Untuk informasi selengkapnya, lihat Cara: Menerapkan Autentikasi Formulir Sederhana.
Jika perubahan kata sandi berhasil, kode di penanganan SendingMail aktivitas mencoba mengirim pesan email kepada pengguna untuk mengonfirmasi perubahan. SMTP harus sudah dikonfigurasi di server agar contoh kode ini berfungsi. Untuk informasi tentang cara mengonfigurasi server SMTP, lihat Cara: Menginstal dan Mengonfigurasi Server Virtual SMTP di IIS 6.0. Untuk tujuan contoh ini, tidak perlu mengonfigurasi server SMTP; contoh dibuat untuk menguji kegagalan mengirim pesan email.
Jika server email tidak dikonfigurasi dengan benar atau terjadi kesalahan lain dan pesan email tidak dapat dikirim, SendMailError fungsi akan dipanggil. Pesan ditampilkan kepada pengguna. Selain itu, peristiwa dicatat ke log peristiwa Aplikasi Windows dengan asumsi bahwa sumber peristiwa bernama MySamplesSite sudah ada. Lihat contoh kode di bawah ini untuk membuat sumber peristiwa yang ditentukan. Untuk informasi selengkapnya tentang membuat sumber kejadian, lihat Penanganan Peristiwa Server di Halaman Formulir Web ASP.NET. Properti HandledSendMailErrorEventArgs objek diatur ke true untuk menunjukkan bahwa kesalahan telah ditangani.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void MySendingMail(object sender, MailMessageEventArgs e)
{
Message1.Text = "Sent mail to you to confirm the password change.";
}
void MySendMailError(object sender, SendMailErrorEventArgs e)
{
Message1.Text = "Could not send email to confirm password change.";
// The MySamplesSite event source has already been created by an administrator.
System.Diagnostics.EventLog myLog = new System.Diagnostics.EventLog();
myLog.Log = "Application";
myLog.Source = "MySamplesSite";
myLog.WriteEntry(
"Sending mail via SMTP failed with the following error: " +
e.Exception.Message.ToString(),
System.Diagnostics.EventLogEntryType.Error);
e.Handled = true;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ChangePassword including a SendMailError Event</title>
</head>
<body>
<form id="form1" runat="server">
<div style="text-align:center">
<h1>ChangePassword</h1>
<asp:LoginView ID="LoginView1" Runat="server"
Visible="true">
<LoggedInTemplate>
<asp:LoginName ID="LoginName1" Runat="server" FormatString="You are logged in as {0}." />
<br />
</LoggedInTemplate>
<AnonymousTemplate>
You are not logged in
</AnonymousTemplate>
</asp:LoginView><br />
<asp:ChangePassword ID="ChangePassword1" Runat="server"
BorderStyle="Solid"
BorderWidth="1"
CancelDestinationPageUrl="~/Default.aspx"
DisplayUserName="true"
OnSendingMail="MySendingMail"
OnSendMailError="MySendMailError"
ContinueDestinationPageUrl="~/Default.aspx" >
<MailDefinition
BodyFileName="~\MailFiles\ChangePasswordMail.htm"
Subject="Activity information for you">
<EmbeddedObjects>
<asp:EmbeddedMailObject Name="LoginGif" Path="~\MailFiles\Login.gif" />
<asp:EmbeddedMailObject Name="PrivacyNoticeTxt" Path="~\MailFiles\PrivacyNotice.txt" />
</EmbeddedObjects>
</MailDefinition>
</asp:ChangePassword><br />
<asp:Label ID="Message1" Runat="server" ForeColor="Red" /><br />
<asp:HyperLink ID="HyperLink1" Runat="server"
NavigateUrl="~/Default.aspx">
Home
</asp:HyperLink>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Public Sub MySendingMail(ByVal Sender As Object, ByVal e As MailMessageEventArgs)
Message1.Text = "Sent mail to you to confirm the password change."
End Sub
Public Sub MySendMailError(ByVal Sender As Object, ByVal e As SendMailErrorEventArgs)
Message1.Text = "Could not send mail to confirm the password change."
' The MySamplesSite event source has already been created by an administrator.
Dim myLog As System.Diagnostics.EventLog
myLog = new System.Diagnostics.EventLog
myLog.Log = "Application"
myLog.Source = "MySamplesSite"
myLog.WriteEntry("Sending mail via SMTP failed with the following error: " & e.Exception.Message.ToString(), System.Diagnostics.EventLogEntryType.Error)
e.Handled = True
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ChangePassword including a SendMailError Event</title>
</head>
<body>
<form id="form1" runat="server">
<div style="text-align:center">
<h1>ChangePassword</h1>
<asp:LoginView ID="LoginView1" Runat="server"
Visible="true">
<LoggedInTemplate>
<asp:LoginName ID="LoginName1" Runat="server" FormatString="You are logged in as {0}." />
<br />
</LoggedInTemplate>
<AnonymousTemplate>
You are not logged in
</AnonymousTemplate>
</asp:LoginView><br />
<asp:ChangePassword ID="ChangePassword1" Runat="server"
BorderStyle="Solid"
BorderWidth="1"
CancelDestinationPageUrl="~/Default.aspx"
DisplayUserName="true"
OnSendingMail="MySendingMail"
OnSendMailError="MySendMailError"
ContinueDestinationPageUrl="~/Default.aspx" >
<MailDefinition
BodyFileName="~\MailFiles\ChangePasswordMail.htm"
Subject="Activity information for you">
<EmbeddedObjects>
<asp:EmbeddedMailObject Name="LoginGif" Path="~\MailFiles\Login.gif" />
<asp:EmbeddedMailObject Name="PrivacyNoticeTxt" Path="~\MailFiles\PrivacyNotice.txt" />
</EmbeddedObjects>
</MailDefinition>
</asp:ChangePassword><br />
<asp:Label ID="Message1" Runat="server" ForeColor="Red" /><br />
<asp:HyperLink ID="HyperLink1" Runat="server"
NavigateUrl="~/Default.aspx">
Home
</asp:HyperLink>
</div>
</form>
</body>
</html>
Gunakan contoh kode berikut jika Anda perlu menambahkan sumber peristiwa bernama MySamplesSite secara terprogram ke log Aplikasi Anda. Sumber kejadian ini harus ada agar contoh kode pertama berfungsi dengan benar. Contoh kode berikut memerlukan hak istimewa Administrator.
#region Using directives
using System;
using System.Collections.Generic;
using System.Text;
using System.Diagnostics;
#endregion
namespace CreateEventSource
{
class Program
{
static void Main(string[] args)
{
try
{
// Create the source, if it does not already exist.
if (!EventLog.SourceExists("MySamplesSite"))
{
EventLog.CreateEventSource("MySamplesSite", "Application");
Console.WriteLine("Creating Event Source");
}
// Create an EventLog instance and assign its source.
EventLog myLog = new EventLog();
myLog.Source = "MySamplesSite";
// Write an informational entry to the event log.
myLog.WriteEntry("Testing writing to event log.");
Console.WriteLine("Message written to event log.");
}
catch (Exception e)
{
Console.WriteLine("Exception:");
Console.WriteLine("{0}", e.ToString());
}
}
}
}
Imports System.Collections.Generic
Imports System.Text
Imports System.Diagnostics
Namespace CreateEventSource
Class Program
Sub Main()
Try
' Create the source, if it does not already exist.
If Not (EventLog.SourceExists("MySamplesSite")) Then
EventLog.CreateEventSource("MySamplesSite", "Application")
Console.WriteLine("Creating Event Source")
End If
' Create an EventLog instance and assign its source.
Dim myLog As New EventLog
myLog.Source = "MySamplesSite"
' Write an informational entry to the event log.
myLog.WriteEntry("Testing writing to event log.")
Console.WriteLine("Message written to event log.")
Catch e As Exception
Console.WriteLine("Exception:")
Console.WriteLine(e.ToString)
End Try
End Sub
End Class
End Namespace
Keterangan
Objek SendMailErrorEventArgs berisi pesan kesalahan yang dimunculkan oleh penyedia surat 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 pengecualian telah terjadi. Ini berguna ketika tidak penting untuk mengirim pesan email. Misalnya, jika pengecualian terjadi ketika pengguna bekerja melalui wizard multi-langkah, mungkin menguntungkan untuk mencatat kesalahan, menampilkan pesan informatif kepada pengguna, dan memungkinkan pengguna untuk menyelesaikan wizard.
Periksa Exception properti untuk menentukan penyebab sebenarnya dari 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 tiba-tiba di lingkungan produksi, dan Anda harus menentukan apakah Anda ingin seluruh aplikasi gagal dalam situasi itu. Jika tidak, menangani peristiwa memungkinkan aplikasi Anda untuk melanjutkan.
Anda harus mengatur Handled properti ke true untuk memberi sinyal bahwa pengecualian telah ditangani; jika tidak, pengecualian ditumbuhkan 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 di kelas turunan OnSendMailError(SendMailErrorEventArgs) , pastikan untuk memanggil OnSendMailError(SendMailErrorEventArgs) metode kelas dasar untuk mengaktifkan delegasi terdaftar untuk menerima peristiwa.
Konstruktor
| SendMailErrorEventArgs(Exception) |
Menginisialisasi instans baru kelas SendMailErrorEventArgs. |
Properti
| 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
| 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 dari instans Type saat ini. (Diperoleh dari Object) |
| MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
