MailAddress Класс

Определение

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

Наследование

Object

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 используется классами и MailMessage для хранения сведений SmtpClient об адресе сообщений электронной почты.

Адрес электронной почты состоит из 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.

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

Свойства

Методы

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