SmtpFailedRecipientsException Klass

Definition

Namnområde:
System.Net.Mail
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Undantaget som utlöses när e-post skickas med en SmtpClient och kan inte levereras till alla mottagare.

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

public ref class SmtpFailedRecipientsException : System::Net::Mail::SmtpFailedRecipientException
[System.Serializable]
public class SmtpFailedRecipientsException : System.Net.Mail.SmtpFailedRecipientException
public class SmtpFailedRecipientsException : System.Net.Mail.SmtpFailedRecipientException
[<System.Serializable>]
type SmtpFailedRecipientsException = class
    inherit SmtpFailedRecipientException
    interface ISerializable
type SmtpFailedRecipientsException = class
    inherit SmtpFailedRecipientException
    interface ISerializable
Public Class SmtpFailedRecipientsException
Inherits SmtpFailedRecipientException
Arv
Object
Exception
SmtpException
SmtpFailedRecipientException
SmtpFailedRecipientsException
Attribut
SerializableAttribute
Implementeringar
ISerializable

Exempel

I följande kodexempel skickas ett e-postmeddelande som inte levererades igen eftersom en postlåda var upptagen eller otillgänglig.

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 InnerExceptions innehåller undantagen som tas emot när du försöker skicka e-post. E-postmeddelandet kan ha levererats till några av mottagarna.

Konstruktorer

Name Description
SmtpFailedRecipientsException()

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Initierar en tom instans av SmtpFailedRecipientsException klassen.
SmtpFailedRecipientsException(SerializationInfo, StreamingContext)

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Initierar en ny instans av SmtpFailedRecipientsException klassen från de angivna instanserna av SerializationInfo klasserna och StreamingContext .
SmtpFailedRecipientsException(String, Exception)

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Initierar en ny instans av SmtpFailedRecipientsException klassen med angiven String och inre Exception.
SmtpFailedRecipientsException(String, SmtpFailedRecipientException[])

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Initierar en ny instans av SmtpFailedRecipientsException klassen med den angivna String matrisen och matrisen av typen SmtpFailedRecipientException.
SmtpFailedRecipientsException(String)

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Initierar en ny instans av SmtpFailedRecipientsException klassen med angiven String.

Egenskaper

Name Description
Data

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från Exception)
FailedRecipient

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Anger e-postadressen med leveransproblem.

(Ärvd från SmtpFailedRecipientException)
HelpLink

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från Exception)
HResult

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från Exception)
InnerException

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från Exception)
InnerExceptions

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Hämtar en eller flera SmtpFailedRecipientExceptionsom anger e-postmottagare med SMTP-leveransfel.
Message

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Hämtar ett meddelande som beskriver det aktuella undantaget.

(Ärvd från Exception)
Source

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från Exception)
StackTrace

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från Exception)
StatusCode

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från SmtpException)
TargetSite

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från Exception)

Metoder

Name Description
Equals(Object)

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från Object)
GetBaseException()

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Fungerar som standard-hash-funktion.

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

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Fyller i en SerializationInfo instans med de data som behövs för att serialisera SmtpFailedRecipientsException.
GetType()

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från Exception)
MemberwiseClone()

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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

(Ärvd från Exception)

Händelser

Name Description
SerializeObjectState

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

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)

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Initierar en ny instans av SmtpFailedRecipientsException klassen från angivna SerializationInfo instanser och StreamingContext instanser.

Gäller för