MailAddress Класс

Определение

Пространство имен:

System.Net.Mail

Сборка:

System.Net.Mail.dll

Исходный код:

MailAddress.cs

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

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.

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

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. Исключение не вызывается, если объект не может быть создан.