MailAddress Oluşturucular

Tanım

Ad Alanı:

System.Net.Mail

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Mail.dll

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

Aşırı Yüklemeler

Name	Description
MailAddress(String)	Belirtilen adresi kullanarak sınıfın MailAddress 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, 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)

Kaynak:

MailAddress.cs

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

public:
 MailAddress(System::String ^ address);

public MailAddress(string address);

new System.Net.Mail.MailAddress : string -> System.Net.Mail.MailAddress

Public Sub New (address As String)

Parametreler

address

String

E-posta String adresi içeren bir.

Özel durumlar

ArgumentNullException

address, null'e eşittir.

ArgumentException

address ("") şeklindedir Empty .

FormatException

address tanınan bir biçimde değil.

Örnekler

Aşağıdaki kod örneği, e-posta iletisinin alıcısı Bcc için bir MailAddress nesne oluşturmak üzere bu oluşturucuyu kullanır.

public static void CreateBccTestMessage(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.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

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

Açıklamalar

Adresi address köşeli ayraç içine alırsanız parametre bir görünen ad ve ilişkili e-posta adresi içerebilir. Örneğin:

"Tom Smith <tsmith@contoso.com>"

Görünen ad ile açılı köşeli ayraçlar arasında boşluk kullanılmasına izin verilir.

Aşağıdaki tabloda, önceki örnek adres kullanılarak yapılan bir MailAddress nesnenin özellik değerleri gösterilmektedir.

Mülkiyet	Değer
DisplayName	"Tom Smith"
Host	"contoso.com"
User	"tsmith"
Address	"tsmith@contoso.com"

MailAddress(String, String)

Kaynak:

MailAddress.cs

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

public:
 MailAddress(System::String ^ address, System::String ^ displayName);

public MailAddress(string address, string? displayName);

new System.Net.Mail.MailAddress : string * string -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String)

Parametreler

address

String

E-posta String adresi içeren bir.

displayName

String

String ile addressilişkilendirilmiş görünen adı içeren bir. Bu parametre olabilir null.

Özel durumlar

ArgumentNullException

address, null'e eşittir.

ArgumentException

address ("") şeklindedir Empty .

FormatException

address tanınan bir biçimde değil.

-veya-

address ASCII olmayan karakterler içerir.

Örnekler

Aşağıdaki kod örneği, bir e-posta iletisinin göndereni ve alıcısı için örnekler oluşturmak MailAddress için bu oluşturucuyu kullanır.

public static void CreateBccTestMessage(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.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

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

Açıklamalar

Görünen addaki baştaki ve sondaki boşluk korunur.

displayName ASCII olmayan karakterler içeriyorsa, kodlama için displayName iso-8859-1 karakter kümesi kullanılır. ASCII olmayan karakterleri kodlama, rfc 1522'de ele alınmaktadır. Bu, adresinde https://www.ietf.org/mevcuttur.

address Görünen bir ad içeriyorsa ve değilse ve displayNamenull buna eşit String.Emptydeğilse, displayName içinde addressbelirtilen değeri geçersiz kılar.

Oluşturucu, MailAddress(String, String) parametrenin displayName geçerli olup olmadığını denetlemez. Bu yöntem, özelliği tarafından görüntülenmeyen çevreleyen DisplayName tırnakları kaldırır. Teklifler iletim öncesinde eklenecektir. UTF8 kodlama özelliğine DisplayName iletim öncesinde uygulanır.

MailAddress(String, String, Encoding)

Kaynak:

MailAddress.cs

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

public:
 MailAddress(System::String ^ address, System::String ^ displayName, System::Text::Encoding ^ displayNameEncoding);

public MailAddress(string address, string? displayName, System.Text.Encoding? displayNameEncoding);

new System.Net.Mail.MailAddress : string * string * System.Text.Encoding -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String, displayNameEncoding As Encoding)

Parametreler

address

String

E-posta String adresi içeren bir.

displayName

String

String ile addressilişkilendirilmiş görünen adı içeren bir.

displayNameEncoding

Encoding

Encoding için displayNamekullanılan karakter kümesini tanımlayan.

Özel durumlar

ArgumentNullException

address, null'e eşittir.

-veya-

displayName, null'e eşittir.

ArgumentException

address ("") şeklindedir Empty .

-veya-

displayName ("") şeklindedir Empty .

FormatException

address tanınan bir biçimde değil.

-veya-

address ASCII olmayan karakterler içerir.

Örnekler

Aşağıdaki kod örneği, e-posta iletisini gönderen için örnekler oluşturmak MailAddress için bu oluşturucuyu kullanır.

// Create a mailing address that includes a UTF8 character
// in the display name.
MailAddress from = new MailAddress("jane@contoso.com",
   "Jane " + (char)0xD8+ " Clayton",
System.Text.Encoding.UTF8);

' Create a mailing address that includes a UTF8 character
' in the display name.
Dim mailFrom As New MailAddress("jane@contoso.com", "Jane " & ChrW(&HD8) & " Clayton", System.Text.Encoding.UTF8)

Açıklamalar

Görünen addaki baştaki ve sondaki boşluk korunur.

address Görünen bir ad içeriyorsa ve değilse ve displayNamenull buna eşit String.Emptydeğilse, displayName içinde addressbelirtilen değeri geçersiz kılar.

Oluşturucu, MailAddress(String, String, Encoding) parametrenin displayName geçerli olup olmadığını denetlemez. Bu yöntem, özelliği tarafından görüntülenmeyen çevreleyen DisplayName tırnakları kaldırır. Parametrede displayNameEncoding belirtilen veya Unicode belirtilen durumlar ASCII dışında, iletim öncesinde tırnak işaretleri eklenir. parametresinde displayNameEncoding belirtilen kodlama, iletim ASCII öncesinde özelliğine DisplayName uygulanır veya Unicode parametresinde displayNameEncoding belirtilir. UTF8 , belirtilmemişse varsayılan kodlamadır.

Desteklenen posta adresi biçimleri hakkında daha fazla bilgi için bkz MailAddress. .