Поделиться через


MailAddress Конструкторы

Определение

Инициализирует новый экземпляр класса MailAddress.

Перегрузки

MailAddress(String)

Инициализирует новый экземпляр класса MailAddress, используя указанный адрес.

MailAddress(String, String)

Инициализирует новый экземпляр класса MailAddress, используя указанный адрес и отображаемое имя.

MailAddress(String, String, Encoding)

Инициализирует новый экземпляр класса MailAddress, используя заданные адрес, отображаемое имя и кодировку.

MailAddress(String)

Исходный код:
MailAddress.cs
Исходный код:
MailAddress.cs
Исходный код:
MailAddress.cs

Инициализирует новый экземпляр класса MailAddress, используя указанный адрес.

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)

Параметры

address
String

Объект String, содержащий адрес электронной почты.

Исключения

address имеет значение null.

address имеет значение Empty ("").

address указан в нераспознаваемом формате.

Примеры

В следующем примере кода этот конструктор используется для создания MailAddress объекта для Bcc получателя сообщения электронной почты.

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());
    }
}

Комментарии

Параметр address может содержать отображаемое имя и связанный адрес электронной почты, если вы заключите адрес в угловые скобки. Пример:

"Tom Smith <tsmith@contoso.com>"

Между отображаемым именем и угловой скобками допускается пробел.

В следующей таблице показаны значения свойств для объекта, созданного MailAddress с помощью адреса в предыдущем примере.

Свойство Значение
DisplayName "Tom Smith"
Host "contoso.com"
User "tsmith"
Address "tsmith@contoso.com"

Применяется к

MailAddress(String, String)

Исходный код:
MailAddress.cs
Исходный код:
MailAddress.cs
Исходный код:
MailAddress.cs

Инициализирует новый экземпляр класса MailAddress, используя указанный адрес и отображаемое имя.

public:
 MailAddress(System::String ^ address, System::String ^ displayName);
public MailAddress (string address, 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)

Параметры

address
String

Объект String, содержащий адрес электронной почты.

displayName
String

Значение String, которое содержит отображаемое имя, связанное с address. Этот параметр может иметь значение null.

Исключения

address имеет значение null.

address имеет значение Empty ("").

address указан в нераспознаваемом формате.

-или-

address содержит символы, отличные от ASCII.

Примеры

В следующем примере кода этот конструктор используется для создания MailAddress экземпляров для отправителя и получателя сообщения электронной почты.

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());
    }
}

Комментарии

Начальные и конечные пробелы в отображаемом имени сохраняются.

Если displayName содержит символы, отличные от ASCII, для кодировки displayName используется набор символов iso-8859-1. Кодирование символов, отличных от ASCII, рассматривается в RFC 1522, который доступен по адресу https://www.ietf.org/.

Если address содержит отображаемое имя, а displayName не null равно и не равно String.Empty, displayName переопределяет значение, указанное в address.

Применяется к

MailAddress(String, String, Encoding)

Исходный код:
MailAddress.cs
Исходный код:
MailAddress.cs
Исходный код:
MailAddress.cs

Инициализирует новый экземпляр класса MailAddress, используя заданные адрес, отображаемое имя и кодировку.

public:
 MailAddress(System::String ^ address, System::String ^ displayName, System::Text::Encoding ^ displayNameEncoding);
public MailAddress (string address, 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)

Параметры

address
String

Объект String, содержащий адрес электронной почты.

displayName
String

Значение String, которое содержит отображаемое имя, связанное с address.

displayNameEncoding
Encoding

Encoding, который определяет набор символов, используемый для параметра displayName.

Исключения

address имеет значение null.

-или-

displayName имеет значение null.

address имеет значение Empty ("").

-или-

displayName имеет значение Empty ("").

address указан в нераспознаваемом формате.

-или-

address содержит символы, отличные от ASCII.

Примеры

В следующем примере кода этот конструктор используется для создания MailAddress экземпляров для отправителя сообщения электронной почты.

// 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)

Комментарии

Начальные и конечные пробелы в отображаемом имени сохраняются.

Если address содержит отображаемое имя, а displayName не null равно и не равно String.Empty, displayName переопределяет значение, указанное в address.

Метод MailAddress не проверка, является ли параметр допустимымdisplayName. Этот метод удаляет окружающие кавычки, не отображаемые свойством DisplayName . Кавычки будут добавлены перед передачей, за исключением случаев, когда ASCII или Unicode указан в параметре displayNameEncoding . Кодировка, указанная в параметре displayNameEncoding , будет применена к свойству DisplayName перед передачей ASCII или Unicode указана в параметре displayNameEncoding . UTF8 — это кодировка по умолчанию, если значение не указано.

Дополнительные сведения о поддерживаемых форматах адресов почты см. в разделе MailAddress.

Применяется к