MailAddress Sınıf

Tanım

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

Devralma

Object

MailAddress

Örnekler

Aşağıdaki kod örneği, , MailAddressve MailMessage sınıflarını kullanarak e-posta iletisi göndermeyi SmtpClientgösterir.

static void CreateCopyMessage( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com",L"Ben Miller" );
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com",L"Jane Clayton" );
   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"Notification_List@contoso.com" );
   message->CC->Add( copy );
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Include credentials if the server requires them.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} by using the SMTP host {1}.", to->Address, client->Host );
   client->Send( message );
   client->~SmtpClient();
}

public static void CreateCopyMessage(string server)
{
    MailAddress from = new MailAddress("ben@contoso.com", "Ben Miller");
    MailAddress to = new MailAddress("jane@contoso.com", "Jane Clayton");
    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("Notification_List@contoso.com");
    message.CC.Add(copy);
    SmtpClient client = new SmtpClient(server);
    // Include credentials if the server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} by using the SMTP host {1}.",
         to.Address, client.Host);

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateCopyMessage(): {0}",
            ex.ToString());
    }
}

Açıklamalar

sınıfı, MailAddress ve MailMessage sınıfları tarafından e-posta iletilerinin SmtpClient adres bilgilerini depolamak için kullanılır.

Posta adresi bir User addan, Host addan ve isteğe bağlı olarak bir DisplayName. , DisplayName kodlarsanız ASCII olmayan karakterler içerebilir.

MailAddress sınıfı aşağıdaki posta adresi biçimlerini destekler:

• basit bir adres biçimi.user@host DisplayName ayarlanmadıysa, oluşturulan posta adresi biçimi budur.

• standart tırnak içine alınmış görünen ad biçimi."display name" <user@host> DisplayName ayarlanırsa, oluşturulan biçim budur.

  • Ad ve Host adın çevresine User açılı ayraçlar eklenir ( bunlar dahil edilmediyse). Örneğin, "display name" user@host olarak değiştirilir "display name" <user@host>.

  • Tırnak işaretleri, dahil edilmediyse çevresine DisplayNameeklenir. Örneğin, display name <user@host> olarak değiştirilir "display name" <user@host>.

  • Özelliğinde DisplayName Unicode karakterler desteklenir.

Bu iki biçim içinde aşağıdaki öğelere izin verilir:

• User Tırnak işaretleri olan bir ad. Örneğin, "user name"@host.

• Kullanıcı adlarında ardışık ve sondaki noktalar. Örneğin, user...name..@host.

• Köşeli ayraçlı etki alanı değişmez değerleri. Örneğin, <user@[my domain]>.

• Yorum. Örneğin, (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Yorumlar iletim öncesinde kaldırılır.

Posta adresleri listesindeki öğeleri ayırmak için virgül kullanılır. Sonuç olarak, bir listedeki tırnaksız görünen adlarda virgül kullanılmamalıdır. Aşağıdaki posta adreslerine izin verilir:

"John, Doe" <user@host>, "Bob, Smith" <user2@host>

Aşağıdaki posta adresine izin verilmez:

John, Doe <user@host>, Bob, Smith <user2@host>

Tırnak işaretleri tırnak içine alınmış bir dizeye eklenebilir, ancak kaçış karakteri kullanılmalıdır. Aşağıdaki posta adreslerine izin verilir:

"John \"Jr\" Doe" <user@host>

"\"John \\\"Jr\\\" Doe\" <user@host>"

Aşağıdaki posta adresine izin verilmez:

"John "Jr" Doe" <user@host>

Kullanıcı adı tırnak içine alınmadığında, dizenin başlangıcı (veya virgül) ile adres arasındaki tüm metinler, açıklamalar da dahil olmak üzere öğesinin DisplayNamebir parçası olarak kabul edilir. Örnek:

(non comment) unquoted display (non comment) name (non comment) <user@host>

Sınıfı bir posta adresini geçerli olarak kabul etse MailAddress de, diğer posta sunucuları posta adresini kabul etmeyebilir.

MailAddress sınıfı aşağıdaki posta adresi biçimlerini desteklemez:

• Karışık tırnak içine alınmış ve tırnak içine alınmamış görünen adlar. Örneğin, display "name" <user@host>.

• IETF tarafından yayımlanan RFC 2822 Bölüm 3.4'te tanımlandığı gibi gruplar.

• veya eski kullanıcı adı biçimleri "user"."name"@hostuser."name"@host"user".name@host.

Oluşturucular

Özellikler

Yöntemler

Şunlara uygulanır