SmtpException Klass

Definition

Representerar undantaget som utlöses när SmtpClient åtgärden inte kan slutföras SendSendAsync .

public ref class SmtpException : Exception
[System.Serializable]
public class SmtpException : Exception
public class SmtpException : Exception
[<System.Serializable>]
type SmtpException = class
    inherit Exception
    interface ISerializable
type SmtpException = class
    inherit Exception
    interface ISerializable
Public Class SmtpException
Inherits Exception
Arv
SmtpException
Härledda
Attribut
Implementeringar

Exempel

I följande kodexempel visas ett felmeddelande när undantaget SmtpException utlöses.

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());
    }
}

Kommentarer

Egenskapen StatusCode innehåller statuskoden som returneras av SMTP-servern.

Konstruktorer

Name Description
SmtpException()

Initierar en ny instans av SmtpException klassen.

SmtpException(SerializationInfo, StreamingContext)

Initierar en ny instans av SmtpException klassen från de angivna instanserna av SerializationInfo klasserna och StreamingContext .

SmtpException(SmtpStatusCode, String)

Initierar en ny instans av SmtpException klassen med den angivna statuskoden och felmeddelandet.

SmtpException(SmtpStatusCode)

Initierar en ny instans av SmtpException klassen med den angivna statuskoden.

SmtpException(String, Exception)

Initierar en ny instans av SmtpException klassen med det angivna felmeddelandet och det inre undantaget.

SmtpException(String)

Initierar en ny instans av SmtpException klassen med det angivna felmeddelandet.

Egenskaper

Name Description
Data

Hämtar en samling nyckel/värde-par som ger ytterligare användardefinierad information om undantaget.

(Ärvd från Exception)
HelpLink

Hämtar eller anger en länk till hjälpfilen som är associerad med det här undantaget.

(Ärvd från Exception)
HResult

Hämtar eller anger HRESULT, ett kodat numeriskt värde som har tilldelats ett specifikt undantag.

(Ärvd från Exception)
InnerException

Hämtar den Exception instans som orsakade det aktuella undantaget.

(Ärvd från Exception)
Message

Hämtar ett meddelande som beskriver det aktuella undantaget.

(Ärvd från Exception)
Source

Hämtar eller anger namnet på programmet eller objektet som orsakar felet.

(Ärvd från Exception)
StackTrace

Hämtar en strängrepresentation av de omedelbara ramarna i anropsstacken.

(Ärvd från Exception)
StatusCode

Hämtar statuskoden som returneras av en SMTP-server när ett e-postmeddelande skickas.

TargetSite

Hämtar den metod som utlöser det aktuella undantaget.

(Ärvd från Exception)

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetBaseException()

När den åsidosätts i en härledd klass returnerar den Exception som är rotorsaken till ett eller flera efterföljande undantag.

(Ärvd från Exception)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetObjectData(SerializationInfo, StreamingContext)

Fyller i en SerializationInfo instans med de data som behövs för att serialisera SmtpException.

GetType()

Hämtar körningstypen för den aktuella instansen.

(Ärvd från Exception)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Skapar och returnerar en strängrepresentation av det aktuella undantaget.

(Ärvd från Exception)

Händelser

Name Description
SerializeObjectState

Inträffar när ett undantag serialiseras för att skapa ett undantagstillståndsobjekt som innehåller serialiserade data om undantaget.

(Ärvd från Exception)

Explicita gränssnittsimplementeringar

Name Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Fyller i en SerializationInfo instans med de data som behövs för att serialisera SmtpException.

Gäller för