SmtpFailedRecipientsException Sınıf

Başvuru

Tanım

Ad Alanı:: System.Net.Mail

Bütünleştirilmiş Kod:: System.Net.Mail.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bir kullanılarak SmtpClient e-posta gönderildiğinde oluşan ve tüm alıcılara teslim edilemeyen özel durum.

Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir.

public ref class SmtpFailedRecipientsException : System::Net::Mail::SmtpFailedRecipientException

public class SmtpFailedRecipientsException : System.Net.Mail.SmtpFailedRecipientException

[System.Serializable]
public class SmtpFailedRecipientsException : System.Net.Mail.SmtpFailedRecipientException

type SmtpFailedRecipientsException = class
    inherit SmtpFailedRecipientException
    interface ISerializable

[<System.Serializable>]
type SmtpFailedRecipientsException = class
    inherit SmtpFailedRecipientException
    interface ISerializable

Public Class SmtpFailedRecipientsException
Inherits SmtpFailedRecipientException

Devralma: Object

Exception

SmtpException

SmtpFailedRecipientException
SmtpFailedRecipientsException

Öznitelikler: SerializableAttribute

Uygulamalar: ISerializable

Örnekler

Aşağıdaki kod örneği, posta kutusu meşgul veya kullanılamıyor olduğundan teslim edilmemiş bir e-posta iletisini yeniden göndermektedir.

static void RetryIfBusy( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com" );
   MailMessage^ message = gcnew MailMessage( from,to );
   
   // message.Subject = "Using the SmtpClient class.";
   message->Subject = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   
   // Add a carbon copy recipient.
   MailAddress^ copy = gcnew MailAddress( L"Notifications@contoso.com" );
   message->CC->Add( copy );
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Include credentials if the server requires them.
   client->Credentials = dynamic_cast<ICredentialsByHost^>(CredentialCache::DefaultNetworkCredentials);
   Console::WriteLine( L"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( L"Delivery failed - retrying in 5 seconds." );
            System::Threading::Thread::Sleep( 5000 );
            client->Send( message );
         }
         else
         {
            Console::WriteLine( L"Failed to deliver message to {0}", ex->InnerExceptions[ i ] );
         }

      }
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in RetryIfBusy(): {0}", 
                     ex->ToString() );
   }
   finally
   {
      client->~SmtpClient();
   }
}

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

Açıklamalar

özelliği, InnerExceptions e-posta göndermeye çalışırken alınan özel durumları içerir. E-posta bazı alıcılara başarıyla teslim edilmiş olabilir.

Oluşturucular

SmtpFailedRecipientsException()	Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. sınıfının boş bir örneğini SmtpFailedRecipientsException başlatır.
SmtpFailedRecipientsException(SerializationInfo, StreamingContext)	Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. ve StreamingContext sınıflarının SmtpFailedRecipientsException belirtilen örneklerinden sınıfının yeni bir örneğini SerializationInfo başlatır.
SmtpFailedRecipientsException(String)	Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. belirtilen Stringile sınıfının yeni bir örneğini SmtpFailedRecipientsException başlatır.
SmtpFailedRecipientsException(String, Exception)	Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. belirtilen String ve iç Exceptionile sınıfının yeni bir örneğini SmtpFailedRecipientsException başlatır.
SmtpFailedRecipientsException(String, SmtpFailedRecipientException[])	Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. türünün belirtilen String ve dizisiyle sınıfının yeni bir örneğini SmtpFailedRecipientsException SmtpFailedRecipientExceptionbaşlatır.

Özellikler

Data	Özel durum hakkında kullanıcı tanımlı ek bilgiler sağlayan bir anahtar/değer çifti koleksiyonu alır. (Devralındığı yer: Exception)
FailedRecipient	Teslim güçlükleriyle birlikte e-posta adresini gösterir. (Devralındığı yer: SmtpFailedRecipientException)
HelpLink	Bu özel durumla ilişkili yardım dosyasının bağlantısını alır veya ayarlar. (Devralındığı yer: Exception)
HResult	Belirli bir özel duruma atanan kodlanmış sayısal bir değer olan HRESULT değerini alır veya ayarlar. (Devralındığı yer: Exception)
InnerException	Exception Geçerli özel duruma neden olan örneği alır. (Devralındığı yer: Exception)
InnerExceptions	Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. SMTP teslim hatalarıyla e-posta alıcılarını gösteren bir veya daha fazla SmtpFailedRecipientExceptions alır.
Message	Geçerli özel durumu açıklayan bir ileti alır. (Devralındığı yer: Exception)
Source	Hataya neden olan uygulamanın veya nesnenin adını alır veya ayarlar. (Devralındığı yer: Exception)
StackTrace	Çağrı yığınındaki anlık çerçevelerin dize gösterimini alır. (Devralındığı yer: Exception)
StatusCode	Bir e-posta iletisi iletildiğinde SMTP sunucusu tarafından döndürülen durum kodunu alır. (Devralındığı yer: SmtpException)
TargetSite	Geçerli özel durumu oluşturan yöntemini alır. (Devralındığı yer: Exception)

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetBaseException()	Türetilmiş bir sınıfta geçersiz kılındığında, sonraki bir veya daha fazla özel durumun kök nedeni olan değerini döndürür Exception . (Devralındığı yer: Exception)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)	Bir SerializationInfo örneği seri hale SmtpFailedRecipientsExceptiongetirmek için gereken verilerle doldurur.
GetType()	Geçerli örneğin çalışma zamanı türünü alır. (Devralındığı yer: Exception)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli özel durumun dize gösterimini oluşturur ve döndürür. (Devralındığı yer: Exception)

Ekinlikler

SerializeObjectState

Kullanımdan kalktı.

Bir özel durum, özel durum hakkında serileştirilmiş veriler içeren bir özel durum nesnesi oluşturmak üzere seri hale getirildiğinde gerçekleşir.

(Devralındığı yer: Exception)

Belirtik Arabirim Kullanımları

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Belirtilen SerializationInfo ve StreamingContext örneklerinden sınıfının yeni bir örneğini SmtpFailedRecipientsException başlatır.

Şunlara uygulanır