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

Ссылка

Определение

Пространство имен:: System.Net.Mail

Сборка:: System.Net.Mail.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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

MailAddress(String)

Исходный код:: MailAddress.cs

Исходный код:: MailAddress.cs

Исходный код:: 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 имеет значение Empty ("").

FormatException

address указан в нераспознаваемом формате.

Примеры

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

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

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	`"Tom Smith"`
Host	`"contoso.com"`
User	`"tsmith"`
Address	`"tsmith@contoso.com"`

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

MailAddress(String, String)

Исходный код:: MailAddress.cs

Исходный код:: MailAddress.cs

Исходный код:: MailAddress.cs

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

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

public MailAddress (string address, 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 имеет значение Empty ("").

FormatException

address указан в нераспознаваемом формате.

-или-

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

Примеры

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

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

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.Empty, displayName переопределяет значение, указанное в address.

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

MailAddress(String, String, Encoding)

Исходный код:: MailAddress.cs

Исходный код:: MailAddress.cs

Исходный код:: 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);

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 имеет значение Empty ("").

-или-

displayName имеет значение Empty ("").

FormatException

address указан в нераспознаваемом формате.

-или-

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

Примеры

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

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

// 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)

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

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

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

Поделиться через

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

Определение

Перегрузки

MailAddress(String)

Параметры

Исключения

Примеры

Комментарии

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

MailAddress(String, String)

Параметры

Исключения

Примеры

Комментарии

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

MailAddress(String, String, Encoding)

Параметры

Исключения

Примеры

Комментарии

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

Дополнительные ресурсы