SmtpException Třída

Definice

Obor názvů:

System.Net.Mail

Sestavení:

netstandard.dll, System.Net.Mail.dll

Zdroj:

SmtpException.cs

Představuje výjimku, která je vyvolán, když SmtpClient není schopen dokončit Send nebo SendAsync operaci.

public ref class SmtpException : Exception

public class SmtpException : Exception

type SmtpException = class
    inherit Exception

Public Class SmtpException
Inherits Exception

Dědičnost

Object

Exception

SmtpException

Odvozené

System.Net.Mail.SmtpFailedRecipientException

Příklady

Následující příklad kódu zobrazí chybovou SmtpException zprávu při vyvolání výjimky.

public static void RetryIfBusy(string server)
{
    MailAddress from = new MailAddress("ben@contoso.com");
    MailAddress to = new MailAddress("jane@contoso.com");
    MailMessage message = new MailMessage(from, to);
    // message.Subject = "Using the SmtpClient class.";
    message.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an email message from an application very easily.";
    // Add a carbon copy recipient.
    MailAddress copy = new MailAddress("Notifications@contoso.com");
    message.CC.Add(copy);
    SmtpClient client = new SmtpClient(server);
    // Include credentials if the server requires them.
    client.Credentials = (ICredentialsByHost)CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} using the SMTP host {1}.",
         to.Address, client.Host);
    try
    {
        client.Send(message);
    }
    catch (SmtpFailedRecipientsException ex)
    {
        for (int i = 0; i < ex.InnerExceptions.Length; i++)
        {
            SmtpStatusCode status = ex.InnerExceptions[i].StatusCode;
            if (status == SmtpStatusCode.MailboxBusy ||
                status == SmtpStatusCode.MailboxUnavailable)
            {
                Console.WriteLine("Delivery failed - retrying in 5 seconds.");
                System.Threading.Thread.Sleep(5000);
                client.Send(message);
            }
            else
            {
                Console.WriteLine("Failed to deliver message to {0}",
                    ex.InnerExceptions[i].FailedRecipient);
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in RetryIfBusy(): {0}",
                ex.ToString());
    }
}

Poznámky

Vlastnost StatusCode obsahuje stavový kód vrácený serverem SMTP.

Konstruktory

Name	Description
SmtpException()	Inicializuje novou instanci SmtpException třídy.
SmtpException(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci SmtpException třídy ze zadaných SerializationInfo instancí třídy a StreamingContext třídy.
SmtpException(SmtpStatusCode, String)	Inicializuje novou instanci SmtpException třídy se zadaným stavovým kódem a chybovou zprávou.
SmtpException(SmtpStatusCode)	Inicializuje novou instanci SmtpException třídy se zadaným stavovým kódem.
SmtpException(String, Exception)	Inicializuje novou instanci SmtpException třídy se zadanou chybovou zprávou a vnitřní výjimkou.
SmtpException(String)	Inicializuje novou instanci SmtpException třídy se zadanou chybovou zprávou.

Vlastnosti

Name	Description
Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovanou číselnou hodnotu, která je přiřazena ke konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Message	Získá zprávu, která popisuje aktuální výjimku. (Zděděno od Exception)
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcové znázornění okamžitých rámců v zásobníku volání. (Zděděno od Exception)
StatusCode	Získá stavový kód vrácený serverem SMTP při přenosu e-mailové zprávy.
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception to, že je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Naplní SerializationInfo instanci dat potřebnými k serializaci objektu SmtpException.
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky. (Zděděno od Exception)

Událost

Name	Description
SerializeObjectState	Zastaralé. Nastane, když je výjimka serializována vytvořit objekt stavu výjimky, který obsahuje serializovaná data o výjimce. (Zděděno od Exception)