SendMailErrorEventArgs.Handled Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Indica se l'eccezione SMTP contenuta nella Exception proprietà è stata gestita.
public:
property bool Handled { bool get(); void set(bool value); };public bool Handled { get; set; }member this.Handled : bool with get, setPublic Property Handled As BooleanValore della proprietà
Se true, l'eccezione viene utilizzata e gestita dal SendMailErrorEventHandler delegato. Se false, l'eccezione viene rigenerata, incluso lo stack di chiamate originale e il messaggio di errore.
Il valore predefinito è false.
Commenti
La Handled proprietà indica se l'oggetto Exception è stato gestito. L'eccezione viene generata dal provider di posta SMTP quando non è possibile inviare un messaggio di posta elettronica dal ChangePassword controllo o dall'oggetto CreateUserWizard. Il motivo più comune dell'eccezione è un errore di configurazione nell'elemento< smtp> (impostazioni di rete) del file di configurazione del computer. Anche se durante lo sviluppo e il debug di un'applicazione viene in genere rilevato un errore simile a questo, i server di posta elettronica possono avere esito negativo in modo imprevisto in un ambiente di produzione ed è necessario determinare se si vuole che l'intera applicazione abbia esito negativo in tale situazione. In caso contrario, la gestione dell'evento consente all'applicazione di continuare.
Se non si crea un gestore eventi per l'evento o se si crea un gestore eventi ma si lascia la proprietà impostata su false, l'applicazione Handled Web smetterà di eseguire se si verifica un errore durante l'invio SendMailError di un messaggio di posta elettronica e ASP.NET visualizzerà un messaggio di errore. La gestione dell'evento consente all'applicazione Web di continuare l'esecuzione anche se si è verificata un'eccezione. Ciò è utile quando non è fondamentale inviare un messaggio di posta elettronica. Ad esempio, se l'eccezione si verifica quando un utente usa una procedura guidata in più passaggi, può essere vantaggioso registrare l'errore, visualizzare un messaggio informativo all'utente e consentire all'utente di completare la procedura guidata.
