MailAddress Sınıf

Tanım

Ad Alanı:

System.Net.Mail

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Mail.dll

Kaynak:

MailAddress.cs

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

Object

MailAddress

Örnekler

Aşağıdaki kod örneği, , SmtpClientve MailAddress sınıflarını kullanarak e-posta iletisi göndermeyi MailMessagegösterir.

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 SmtpClient sınıfları tarafından e-posta iletilerinin MailMessage adres bilgilerini depolamak için kullanılır.

Posta adresi bir kullanıcı adından, ana bilgisayar adından ve isteğe bağlı bir görünen addan oluşur. 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çinde görünen ad biçimi."display name" <user@host> DisplayName ayarlanırsa, oluşturulan biçim budur.

  • Henüz dahil edilmediyse, ad ve User adın çevresine Host açılı ayraçlar eklenir. Örneğin, "display name" user@host olarak "display name" <user@host>değiştirilir.
  • Henüz dahil edilmediyse, tırnak işaretleri çevresine DisplayNameeklenir. Örneğin, display name <user@host> olarak "display name" <user@host>değiştirilir.
  • Unicode karakterleri özelliğinde DisplayName desteklenir.

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

• User Tırnak işaretleri içeren bir ad. Ö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.
• .NET 9 ve öncesi YALNIZCA: Kullanıcı adlarında ardışık ve sondaki noktalar. Örneğin, user...name..@host. (.NET 10'dan başlayarak ardışık noktalara izin verilmez.)

Posta adresleri listesindeki öğeleri ayırmak için virgül kullanılır. Sonuç olarak, listedeki sıralanmamış 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çışları olmalı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ı alıntılanmadığı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. Örneğin:

(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 alıntılı ve alıntısız görünen adlar. Örneğin, display "name" <user@host>.
• IETF tarafından yayımlanan RFC 2822 Bölüm 3.4'te tanımlanan gruplar.
• veya 'nin "user"."name"@hostuser."name"@host"user".name@hosteski kullanıcı adı biçimleri.
• Yalnızca 10 ve sonraki sürümleri .NET: Kullanıcı adında ardışık noktalar, örneğin, user...name@host.com.

Oluşturucular

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

Özellikler

Name	Description
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

Name	Description
Equals(Object)	İki posta adresini karşılaştırır.
GetHashCode()	Posta adresi için bir karma değer döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Bu örneğin dize gösterimini döndürür.
TryCreate(String, MailAddress)	Yeni MailAddressbir oluşturur. Nesne oluşturulamıyorsa özel durum oluşturmaz.
TryCreate(String, String, Encoding, MailAddress)	Yeni bir MailAddressoluşturun. Nesne oluşturulamıyorsa özel durum oluşturmaz.
TryCreate(String, String, MailAddress)	Yeni bir MailAddressoluşturun. Nesne oluşturulamıyorsa özel durum oluşturmaz.