MailAddress Класс

Определение

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

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

Примеры

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

  • Группы, определенные в RFC 2822, раздел 3.4, опубликованный 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. Не создает исключение, если объект не может быть создан.

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