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

Определение

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

System.Net.Mail

Сборки:

netstandard.dll, System.Net.Mail.dll

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

Перегрузки

Имя	Описание
MailAddress(String)	Инициализирует новый экземпляр класса с помощью указанного MailAddress адреса.
MailAddress(String, String)	Инициализирует новый экземпляр класса с помощью указанного MailAddress адреса и отображаемого имени.
MailAddress(String, String, Encoding)	Инициализирует новый экземпляр класса с помощью указанного MailAddress адреса, отображаемого имени и кодирования.

MailAddress(String)

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

MailAddress.cs

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

public:
 MailAddress(System::String ^ address);

public MailAddress(string address);

new System.Net.Mail.MailAddress : string -> System.Net.Mail.MailAddress

Public Sub New (address As String)

Параметры

address

String

Объект, String содержащий адрес электронной почты.

Исключения

ArgumentNullException

address равно null.

ArgumentException

address is Empty ("").

FormatException

address не находится в распознаваемом формате.

Примеры

В следующем примере кода этот конструктор используется для создания MailAddress объекта для Bcc получателя сообщения электронной почты.

public static void CreateBccTestMessage(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.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateBccTestMessage(): {0}",
            ex.ToString());
    }
}

Комментарии

Параметр address может содержать отображаемое имя и связанный адрес электронной почты, если заключить адрес в угловые скобки. Рассмотрим пример.

"Tom Smith <tsmith@contoso.com>"

Пробелы допускаются между отображаемой и угловой скобками.

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

Недвижимость	Ценность
DisplayName	"Tom Smith"
Host	"contoso.com"
User	"tsmith"
Address	"tsmith@contoso.com"

MailAddress(String, String)

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

MailAddress.cs

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

public:
 MailAddress(System::String ^ address, System::String ^ displayName);

public MailAddress(string address, string? displayName);

new System.Net.Mail.MailAddress : string * string -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String)

Параметры

address

String

Объект, String содержащий адрес электронной почты.

displayName

String

Значение String , содержащее отображаемое имя, связанное с address. Этот параметр может иметь значение null.

Исключения

ArgumentNullException

address равно null.

ArgumentException

address is Empty ("").

FormatException

address не находится в распознаваемом формате.

–или–

address содержит символы, отличные от ASCII.

Примеры

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

public static void CreateBccTestMessage(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.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateBccTestMessage(): {0}",
            ex.ToString());
    }
}

Комментарии

В отображаемом имени сохраняются начальные и конечные пробелы.

Если displayName содержит символы, отличные от ASCII, для кодирования используется displayName набор символов iso-8859-1. Кодировка символов, отличных от ASCII, рассматривается в RFC 1522, которая доступна по адресу https://www.ietf.org/.

Если address содержит отображаемое имя и displayName не null равноString.EmptydisplayName, переопределяет значение, указанное вaddress.

Конструктор MailAddress(String, String) не проверяет, является ли параметр допустимым displayName . Этот метод удаляет окружающие кавычки, которые не отображаются свойством DisplayName . Кавычки будут добавлены перед передачей. UTF8 кодировка будет применена к свойству перед передачей DisplayName .

MailAddress(String, String, Encoding)

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

MailAddress.cs

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

public:
 MailAddress(System::String ^ address, System::String ^ displayName, System::Text::Encoding ^ displayNameEncoding);

public MailAddress(string address, string? displayName, System.Text.Encoding? displayNameEncoding);

new System.Net.Mail.MailAddress : string * string * System.Text.Encoding -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String, displayNameEncoding As Encoding)

Параметры

address

String

Объект, String содержащий адрес электронной почты.

displayName

String

Значение String , содержащее отображаемое имя, связанное с address.

displayNameEncoding

Encoding

Определение Encoding набора символов, используемого для displayName.

Исключения

ArgumentNullException

address равно null.

–или–

displayName равно null.

ArgumentException

address is Empty ("").

–или–

displayName is Empty ("").

FormatException

address не находится в распознаваемом формате.

–или–

address содержит символы, отличные от ASCII.

Примеры

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

// Create a mailing address that includes a UTF8 character
// in the display name.
MailAddress from = new MailAddress("jane@contoso.com",
   "Jane " + (char)0xD8+ " Clayton",
System.Text.Encoding.UTF8);

' Create a mailing address that includes a UTF8 character
' in the display name.
Dim mailFrom As New MailAddress("jane@contoso.com", "Jane " & ChrW(&HD8) & " Clayton", System.Text.Encoding.UTF8)

Комментарии

В отображаемом имени сохраняются начальные и конечные пробелы.

Если address содержит отображаемое имя и displayName не null равноString.EmptydisplayName, переопределяет значение, указанное вaddress.

Конструктор MailAddress(String, String, Encoding) не проверяет, является ли параметр допустимым displayName . Этот метод удаляет окружающие кавычки, которые не отображаются свойством DisplayName . Кавычки будут добавлены перед передачей, за исключением того, где ASCII или Unicode указан в параметре displayNameEncoding . Кодировка, указанная в параметре displayNameEncoding , будет применена к DisplayName свойству перед передачей ASCII или Unicode указана в параметре displayNameEncoding . UTF8 — это кодировка по умолчанию, если ни один из них не указан.

Дополнительные сведения о поддерживаемых форматах почтовых адресов см. в разделе MailAddress.