PasswordRecovery.OnSendMailError(SendMailErrorEventArgs) Método

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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, aumenta novamente a exceção mantendo 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 Tratamento 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, chame o OnSendMailError(SendMailErrorEventArgs) método para a classe base para que os delegados registrados recebam o evento.

Aplica-se a

Partilhar via