MailAddress Класс

Определение

Представляет адрес отправителя или получателя электронной почты.Represents the address of an electronic mail sender or recipient.

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

Примеры

В следующем примере кода демонстрируется отправка сообщения электронной почты с помощью SmtpClient MailAddress классов, и MailMessage .The following code example demonstrates sending an email message by using the SmtpClient, MailAddress, and MailMessage classes.

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 для хранения сведений об адресах сообщений электронной почты.The MailAddress class is used by the SmtpClient and MailMessage classes to store address information for email messages.

Адрес электронной почты состоит из User имени, Host имени и (необязательно) DisplayName .A mail address is composed of a User name, Host name and optionally, a DisplayName. DisplayNameПри кодировании может содержать символы, не входящие в набор ASCII.The DisplayName can contain non-ASCII characters if you encode them.

MailAddressКласс поддерживает следующие форматы адресов электронной почты:The MailAddress class supports the following mail address formats:

  • Простой формат адреса user@host .A simple address format of user@host. Если значение DisplayName не задано, это формат почтового адреса.If a DisplayName is not set, this is the mail address format generated.

  • Стандартный формат отображаемого имени в кавычках "display name" <user@host> .A standard quoted display name format of "display name" <user@host>. Если DisplayName задано значение, то создается формат.If a DisplayName is set, this is the format generated.

  • Угловые скобки добавляются вокруг User имени и Host имени, если они не включены.Angle brackets are added around the User name and Host name, if these are not included. Например, "display name" user@host изменяется на "display name" <user@host> .For example, "display name" user@host is changed to "display name" <user@host>.

  • Кавычки добавляются вокруг DisplayName , если они не включены.Quotes are added around the DisplayName, if these are not included. Например, display name <user@host> изменяется на "display name" <user@host> .For example, display name <user@host> is changed to "display name" <user@host>.

  • В свойстве поддерживаются символы Юникода DisplayName .Unicode characters are supported in the DisplayName property.

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

  • Последовательные и конечные точки в именах пользователей.Consecutive and trailing dots in user names. Например, user...name..@host.For example, user...name..@host.

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

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

Запятая используется для разделения элементов в списке адресов электронной почты.A comma is used to separate elements in a list of mail addresses. В результате запятая не должна использоваться в отображаемых именах, не заключенных в кавычки, в списке.As a result, a comma should not be used in unquoted display names in a list. Можно использовать следующие адреса электронной почты:The following mail addresses would be allowed:

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

Следующий почтовый адрес не будет разрешен:The following mail address would not be allowed:

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

Кавычки можно внедрять в строку в кавычках, но они должны быть экранированы.Quotes can be embedded in a quoted string, but they must be escaped. Можно использовать следующие адреса электронной почты:The following mail addresses would be allowed:

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

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

Следующий почтовый адрес не будет разрешен:The following mail address would not be allowed:

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

Если имя пользователя не заключено в кавычки, весь текст между началом строки (или запятой) и адресом считается частью элемента DisplayName , включая комментарии.When the username is not quoted, all text between the start of the string (or comma) and the address are considered part of the DisplayName, including comments. Примеры.For example:

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

Несмотря на то MailAddress , что класс принимает почтовый адрес как допустимый, другие почтовые серверы могут не принимать адрес электронной почты.Although the MailAddress class accepts a mail address as valid, other mail servers may not accept the mail address.

MailAddressКласс не поддерживает следующие форматы адресов электронной почты:The MailAddress class does not support the following mail address formats:

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

  • Группы, как определено в 3,4 разделе RFC 2822, опубликованном IETF.Groups, as defined in RFC 2822 Section 3.4 published by the IETF.

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

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

MailAddress(String)

Инициализирует новый экземпляр класса MailAddress, используя указанный адрес.Initializes a new instance of the MailAddress class using the specified address.

MailAddress(String, String)

Инициализирует новый экземпляр класса MailAddress, используя указанный адрес и отображаемое имя.Initializes a new instance of the MailAddress class using the specified address and display name.

MailAddress(String, String, Encoding)

Инициализирует новый экземпляр класса MailAddress, используя заданные адрес, отображаемое имя и кодировку.Initializes a new instance of the MailAddress class using the specified address, display name, and encoding.

Свойства

Address

Возвращает адрес электронной почты, указанный при создании этого экземпляра.Gets the email address specified when this instance was created.

DisplayName

Возвращает отображаемое имя, составленное из отображаемого имени и информации об адресе, заданных при создании этого экземпляра.Gets the display name composed from the display name and address information specified when this instance was created.

Host

Возвращает строку узла из адреса электронной почты, заданного при создании экземпляра.Gets the host portion of the address specified when this instance was created.

User

Возвращает информацию о пользователе из адреса электронной почты, указанного при создании экземпляра.Gets the user information from the address specified when this instance was created.

Методы

Equals(Object)

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

GetHashCode()

Возвращает значение хэш-функции для почтового адреса.Returns a hash value for a mail address.

GetType()

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

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Возвращает строковое представление данного экземпляра.Returns a string representation of this instance.

TryCreate(String, MailAddress)

Создает новый экземпляр MailAddress.Creates a new MailAddress. Не создает исключение, если не удается создать объект.Does not throw an exception if the object cannot be created.

TryCreate(String, String, Encoding, MailAddress)

Создайте MailAddress.Create a new MailAddress. Не создает исключение, если не удается создать объект.Does not throw an exception if the object cannot be created.

TryCreate(String, String, MailAddress)

Создайте MailAddress.Create a new MailAddress. Не создает исключение, если не удается создать объект.Does not throw an exception if the object cannot be created.

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