SendMailErrorEventArgs Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt gegevens voor de SendMailError gebeurtenis van besturingselementen, zoals het ChangePassword besturingselement, het CreateUserWizard besturingselement en het PasswordRecovery besturingselement.
public ref class SendMailErrorEventArgs : EventArgspublic class SendMailErrorEventArgs : EventArgstype SendMailErrorEventArgs = class
inherit EventArgsPublic Class SendMailErrorEventArgs
Inherits EventArgs- Overname
Opmerkingen
Het SendMailErrorEventArgs object bevat een foutbericht dat wordt gegenereerd door de SMTP-e-mailprovider wanneer een e-mailbericht niet kan worden verzonden door het ChangePassword besturingselement of het CreateUserWizard besturingselement. In dat geval wordt het SendMailErrorEventArgs object verzonden naar de SendMailErrorEventHandler.
Maak een SendMailErrorEventHandler gemachtigde om de gebeurtenis af te handelen. Door de gebeurtenis te verwerken, kan uw webtoepassing blijven worden uitgevoerd, ook al is er een uitzondering opgetreden. Dit is handig wanneer het niet essentieel is om een e-mailbericht te verzenden. Als de uitzondering bijvoorbeeld optreedt wanneer een gebruiker via een wizard met meerdere stappen werkt, kan het handig zijn om de fout te registreren, een informatief bericht weer te geven aan de gebruiker en de gebruiker de wizard te laten voltooien.
Bekijk de Exception eigenschap om de werkelijke oorzaak van de uitzondering te bepalen. De meest voorkomende reden voor de uitzondering is een configuratiefout in het <smtp-element> (netwerkinstellingen) van het computerconfiguratiebestand. Hoewel een fout zoals deze meestal wordt gedetecteerd tijdens de ontwikkeling en foutopsporing van een toepassing, kunnen e-mailservers onverwacht mislukken in een productieomgeving en moet u bepalen of u wilt dat de hele toepassing in die situatie mislukt. Als dat niet het geval is, kan uw toepassing doorgaan met het afhandelen van de gebeurtenis.
U moet de Handled eigenschap instellen om true aan te geven dat de uitzondering is verwerkt. Anders wordt de uitzondering opnieuw geplaatst en wordt de oorspronkelijke aanroepstack en het foutbericht opgenomen.
Als u geen gebeurtenis-handler maakt voor de gebeurtenis SendMailError, of als u een gebeurtenis-handler maakt, maar de eigenschap Handled ingesteld op false, wordt de webtoepassing niet meer uitgevoerd als er een fout optreedt bij het verzenden van een e-mailbericht en ASP.NET wordt een foutbericht weergegeven.
Met OnSendMailError de methode kunnen afgeleide klassen ook de gebeurtenis afhandelen, in plaats van dit door de SendMailErrorEventHandler. Dit is de voorkeurstechniek voor het verwerken van de gebeurtenis in een klasse die is afgeleid van ChangePassword of CreateUserWizard.
Zie Server Event Handling in ASP.NET Web Forms Pages voor meer informatie over het afhandelen van gebeurtenissen.
Notities voor overnemers
Wanneer u OnSendMailError(SendMailErrorEventArgs) overschrijft in een afgeleide klasse, moet u de OnSendMailError(SendMailErrorEventArgs) methode van de basisklasse aanroepen om geregistreerde gemachtigden in staat te stellen de gebeurtenis te ontvangen.
Constructors
| Name | Description |
|---|---|
| SendMailErrorEventArgs(Exception) |
Initialiseert een nieuw exemplaar van de SendMailErrorEventArgs klasse. |
Eigenschappen
| Name | Description |
|---|---|
| Exception |
Retourneert de uitzondering die is gegenereerd door een SMTP-e-mailservice wanneer een e-mailbericht niet kan worden verzonden. |
| Handled |
Geeft aan of de SMTP-uitzondering die in de Exception eigenschap is opgenomen, is verwerkt. |
Methoden
| Name | Description |
|---|---|
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |