PasswordRecovery.OnSendMailError(SendMailErrorEventArgs) Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Aciona o evento SendMailError quando uma mensagem de email não pode ser enviada ao usuário.

protected:
 virtual void OnSendMailError(System::Web::UI::WebControls::SendMailErrorEventArgs ^ e);
protected virtual void OnSendMailError (System.Web.UI.WebControls.SendMailErrorEventArgs e);
abstract member OnSendMailError : System.Web.UI.WebControls.SendMailErrorEventArgs -> unit
override this.OnSendMailError : System.Web.UI.WebControls.SendMailErrorEventArgs -> unit
Protected Overridable Sub OnSendMailError (e As SendMailErrorEventArgs)

Parâmetros

e
SendMailErrorEventArgs

Um SendMailErrorEventArgs que contém os dados do evento.

Comentários

O OnSendMailError método é chamado quando o serviço SMTP Mail gera uma exceção. A implementação padrão gera o SendMailError erro e, se a exceção não for tratada, gera novamente a exceção enquanto mantém a pilha de chamadas.

Examine a Exception propriedade do SendMailErrorEventArgs objeto passado como o e parâmetro para determinar a causa real da exceção. Durante o desenvolvimento, o motivo mais comum pelo qual o SendMailError evento é gerado é que a <smtpMail> seção do arquivo Web.config está incorreta. Após a implantação, esse evento pode ocorrer por vários motivos, a maioria tendo a ver com erros em um endereço de email.

Você deve definir a Handled propriedade do objeto passado como o e parâmetro para true sinalizar que a exceção foi tratada; caso contrário, a exceção será lançada novamente.

A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulação de eventos de servidor em páginas ASP.NET Web Forms.

O OnSendMailError método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.

Notas aos Herdeiros

Ao substituir o OnSendMailError(SendMailErrorEventArgs) método em uma classe derivada, certifique-se de chamar o OnSendMailError(SendMailErrorEventArgs) método para a classe base para que os delegados registrados recebam o evento.

Aplica-se a

Confira também