MailAddress Oluşturucular

Tanım

Ad Alanı:

System.Net.Mail

Bütünleştirilmiş Kod:

System.Net.Mail.dll

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

Aşırı Yüklemeler

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 yeni bir örneğini başlatır.

MailAddress(String)

Kaynak:

MailAddress.cs

Belirtilen adresi kullanarak sınıfının yeni bir örneğini MailAddress 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

String E-posta adresi içeren bir.

Özel durumlar

ArgumentNullException

address, null değeridir.

ArgumentException

address (" 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.

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

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 parametresi bir görünen ad ve ilişkili e-posta adresini içerebilir. Örnek:

"Tom Smith <tsmith@contoso.com>"

Görünen ad ile açılı ayraçlar arasında boşluka izin verilir.

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

Özellik	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 MailAddress yeni bir örneğini 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

String E-posta 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 değeridir.

ArgumentException

address (" 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.

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

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 konusu, adresinde bulunan RFC 1522'de https://www.ietf.org/ele alınmaktadır.

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

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

String E-posta 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 değeridir.

-veya-

displayName, null değeridir.

ArgumentException

address (" Empty ").

-veya-

displayName (" 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 iletisini gönderene ö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 = gcnew MailAddress("jane@contoso.com",
    "Jane " + (wchar_t)0xD8 + " Clayton",
    System::Text::Encoding::UTF8);

// 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 null ve displayName eşit String.Emptydeğilse, displayName içinde addressbelirtilen değeri geçersiz kılar.

MailAddress yöntemi parametrenin displayName geçerli olup olmadığını denetlemez. Bu yöntem özelliği tarafından DisplayName görüntülenmeyen çevresindeki tırnakları kaldırır. Tırnak işaretleri, parametrede belirtildiği veya belirtildiği durumlar ASCII dışında iletim öncesinde displayNameEncoding eklenir.Unicode 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. .