MailAddress Sınıf

Tanım

Elektronik posta gönderenin veya alıcının adresini temsil eder.

public ref class MailAddress
public class MailAddress
type MailAddress = class
Public Class MailAddress
Devralma
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

MailAddress(String)

Belirtilen adresi kullanarak sınıfının yeni bir örneğini MailAddress başlatır.

MailAddress(String, String)

Belirtilen adresi ve görünen adı kullanarak sınıfın MailAddress yeni bir örneğini başlatır.

MailAddress(String, String, Encoding)

Belirtilen adresi, görünen adı ve kodlamayı MailAddress kullanarak sınıfının yeni bir örneğini başlatır.

Özellikler

Address

Bu örnek oluşturulduğunda belirtilen e-posta adresini alır.

DisplayName

Bu örnek oluşturulduğunda belirtilen görünen ad ve adres bilgilerinden oluşturulan görünen adı alır.

Host

Bu örnek oluşturulduğunda belirtilen adresin ana bilgisayar bölümünü alır.

User

Bu örnek oluşturulduğunda belirtilen adresten kullanıcı bilgilerini alır.

Yöntemler

Equals(Object)

İki posta adresini karşılaştırır.

GetHashCode()

Posta adresi için karma değer döndürür.

GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Bu örneğin dize gösterimini döndürür.

TryCreate(String, MailAddress)

Yeni bir MailAddress oluşturur. Nesne oluşturulamazsa özel durum oluşturmaz.

TryCreate(String, String, Encoding, MailAddress)

Yeni MailAddressbir İçerik Oluşturucu. Nesne oluşturulamazsa özel durum oluşturmaz.

TryCreate(String, String, MailAddress)

Yeni MailAddressbir İçerik Oluşturucu. Nesne oluşturulamazsa özel durum oluşturmaz.

Şunlara uygulanır