MailAddress Класс

Определение

Представляет адрес отправителя или получателя электронной почты.

public ref class MailAddress
public class MailAddress
type MailAddress = class
Public Class MailAddress
Наследование
MailAddress

Примеры

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

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

Комментарии

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

Адрес электронной почты состоит из User имени, Host имени и (необязательно) DisplayName . DisplayNameПри кодировании может содержать символы, не входящие в набор ASCII.

MailAddressКласс поддерживает следующие форматы адресов электронной почты:

  • Простой формат адреса user@host . Если значение DisplayName не задано, это формат почтового адреса.

  • Стандартный формат отображаемого имени в кавычках "display name" <user@host> . Если DisplayName задано значение, то создается формат.

  • Угловые скобки добавляются вокруг User имени и Host имени, если они не включены. Например, "display name" user@host изменяется на "display name" <user@host> .

  • Кавычки добавляются вокруг DisplayName , если они не включены. Например, display name <user@host> изменяется на "display name" <user@host> .

  • В свойстве поддерживаются символы Юникода DisplayName .

  • UserИмя с кавычками. Например, "user name"@host.

  • Последовательные и конечные точки в именах пользователей. Например, user...name..@host.

  • Литералы домена в квадратных скобках. Например, <user@[my domain]>.

  • Примечания. Например, (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Комментарии удаляются перед передачей.

Запятая используется для разделения элементов в списке адресов электронной почты. В результате запятая не должна использоваться в отображаемых именах, не заключенных в кавычки, в списке. Можно использовать следующие адреса электронной почты:

"John, Doe" <user@host>, "Bob, Smith" <user2@host>

Следующий почтовый адрес не будет разрешен:

John, Doe <user@host>, Bob, Smith <user2@host>

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

"John \"Jr\" Doe" <user@host>

"\"John \\\"Jr\\\" Doe\" <user@host>"

Следующий почтовый адрес не будет разрешен:

"John "Jr" Doe" <user@host>

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

(non comment) unquoted display (non comment) name (non comment) <user@host>

Несмотря на то MailAddress , что класс принимает почтовый адрес как допустимый, другие почтовые серверы могут не принимать адрес электронной почты.

MailAddressКласс не поддерживает следующие форматы адресов электронной почты:

  • Имена отображаемых имен в кавычках и без кавычек. Например, display "name" <user@host>.

  • Группы, как определено в 3,4 разделе RFC 2822, опубликованном IETF.

  • Устаревшие форматы имени пользователя "user"."name"@host , user."name"@host или "user".name@host .

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

MailAddress(String)

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

MailAddress(String, String)

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

MailAddress(String, String, Encoding)

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

Свойства

Address

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

DisplayName

Возвращает отображаемое имя, составленное из отображаемого имени и информации об адресе, заданных при создании этого экземпляра.

Host

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

User

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

Методы

Equals(Object)

Сравнивает два адреса электронной почты.

GetHashCode()

Возвращает значение хэш-функции для почтового адреса.

GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строковое представление данного экземпляра.

TryCreate(String, MailAddress)

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

TryCreate(String, String, Encoding, MailAddress)

Создайте MailAddress. Не создает исключение, если не удается создать объект.

TryCreate(String, String, MailAddress)

Создайте MailAddress. Не создает исключение, если не удается создать объект.

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