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

Определение

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

System.Net.Mail

Сборки:

netstandard.dll, System.Net.Mail.dll

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

Перегрузки

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

MailMessage()

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

MailMessage.cs

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

public:
 MailMessage();

public MailMessage();

Public Sub New ()

Комментарии

В качестве значения в сетевом элементедля smtp-элемента> mailSettings<(параметры сети) задано значение, если оно существует.

MailMessage(MailAddress, MailAddress)

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

MailMessage.cs

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

public:
 MailMessage(System::Net::Mail::MailAddress ^ from, System::Net::Mail::MailAddress ^ to);

public MailMessage(System.Net.Mail.MailAddress from, System.Net.Mail.MailAddress to);

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

Public Sub New (from As MailAddress, to As MailAddress)

Параметры

from

MailAddress

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

to

MailAddress

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

Исключения

ArgumentNullException

from равно null.

–или–

to равно null.

FormatException

from или to неправильно сформирован.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

public static void CreateTestMessage3()
{
    MailAddress to = new MailAddress("jane@contoso.com");
    MailAddress from = new MailAddress("ben@contoso.com");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    // Use the application or machine configuration to get the
    // host, port, and credentials.
    SmtpClient client = new SmtpClient();
    Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.",
        to.User, to.Host, client.Host);
    client.Send(message);
}

Public Shared Sub CreateTestMessage3()
    Dim [to] As MailAddress = New MailAddress("jane@contoso.com")
    Dim from As MailAddress = New MailAddress("ben@contoso.com")
    Dim message As MailMessage = New MailMessage(from, [to])
    message.Subject = "Using the new SMTP client."
    message.Body = "Using this new feature, you can send an email message from an application very easily."
    'Use the application or machine configuration to get the
    ' host, port, And credentials.
    Dim client As SmtpClient = New SmtpClient()
    Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.", [to].User, [to].Host, client.Host)
    client.Send(message)
End Sub

Комментарии

Свойство From инициализировано с помощью from инициализируется To с помощью toсвойства.

MailMessage(String, String)

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

MailMessage.cs

Инициализирует новый экземпляр MailMessage класса с помощью указанных String объектов класса.

public:
 MailMessage(System::String ^ from, System::String ^ to);

public MailMessage(string from, string to);

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

Public Sub New (from As String, to As String)

Параметры

from

String

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

to

String

Объект, String содержащий адреса получателей сообщения электронной почты. Несколько адресов электронной почты должны быть разделены символом запятой (",").

Исключения

ArgumentNullException

from равно null.

–или–

to равно null.

ArgumentException

from is Empty ("").

–или–

to is Empty ("").

FormatException

from или to неправильно сформирован.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

public static void CreateTestMessage2(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    SmtpClient client = new SmtpClient(server);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = true;

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

Public Shared Sub CreateTestMessage2(ByVal server As String)
    Dim [to] As String = "jane@contoso.com"
    Dim from As String = "ben@contoso.com"
    Dim message As MailMessage = New MailMessage(from, [to])
    message.Subject = "Using the new SMTP client."
    message.Body = "Using this new feature, you can send an email message from an application very easily."
    Dim client As SmtpClient = New SmtpClient(server)
    ' Credentials are necessary if the server requires the client
    ' to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = True

    Try
        client.Send(message)
    Catch ex As Exception
        Console.WriteLine("Exception caught in CreateTestMessage2(): {0}", ex.ToString())
    End Try
End Sub

Комментарии

Свойство From инициализировано с помощью from инициализируется To с помощью toсвойства.

MailMessage(String, String, String, String)

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

MailMessage.cs

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

public:
 MailMessage(System::String ^ from, System::String ^ to, System::String ^ subject, System::String ^ body);

public MailMessage(string from, string to, string? subject, string? body);

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

Public Sub New (from As String, to As String, subject As String, body As String)

Параметры

from

String

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

to

String

Объект, String содержащий адреса получателей сообщения электронной почты. Несколько адресов электронной почты должны быть разделены символом запятой (",").

subject

String

Объект, String содержащий текст темы.

body

String

Объект, String содержащий текст сообщения.

Исключения

ArgumentNullException

from равно null.

–или–

to равно null.

ArgumentException

from is Empty ("").

–или–

to is Empty ("").

FormatException

from или to неправильно сформирован.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

public static void CreateTimeoutTestMessage(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server);
    Console.WriteLine("Changing time out from {0} to 100.", client.Timeout);
    client.Timeout = 100;
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Public Shared Sub CreateTimeoutTestMessage(ByVal server As String)
    Dim [to] As String = "jane@contoso.com"
    Dim from As String = "ben@contoso.com"
    Dim subject As String = "Using the new SMTP client."
    Dim body As String = "Using this new feature, you can send an email message from an application very easily."
    Dim message As MailMessage = New MailMessage(from, [to], subject, body)
    Dim client As SmtpClient = New SmtpClient(server)
    Console.WriteLine("Changing time out from {0} to 100.", client.Timeout)
    client.Timeout = 100
    ' Credentials are necessary if the server requires the client
    ' to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials
    client.Send(message)
End Sub

Комментарии

Свойства нового MailMessage объекта инициализированы следующим образом:

Параметр	Недвижимость
from	From
to	To
subject	Subject
body	Body

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