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

Определение

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

Перегрузки

MailMessage()

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

MailMessage(MailAddress, MailAddress)

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

MailMessage(String, String)

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

MailMessage(String, String, String, String)

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

MailMessage()

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

public:
 MailMessage();
public MailMessage ();
Public Sub New ()

Комментарии

Для параметра From задается значение в сетевом элементе для элемента mailSettingssmtp<> (Network Параметры), если оно существует.

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

MailMessage(MailAddress, MailAddress)

Инициализирует новый экземпляр класса 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, содержащий адрес получателя сообщения электронной почты.

Исключения

from имеет значение null.

-или- to имеет значение null.

Параметр from или to имеет неправильный формат.

Примеры

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

static void CreateTestMessage3()
{
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com" );
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the new SMTP client.";
   message->Body = L"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 = gcnew SmtpClient;
   Console::WriteLine( L"Sending an email message to {0} at {1} by using the SMTP host {2}.", to->User, to->Host, client->Host );
   client->Send( message );
}
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, используя указанные объекты класса 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, содержащее адреса получателей сообщения электронной почты. Несколько адресов электронной почты необходимо разделять запятыми (",").

Исключения

from имеет значение null.

-или- to имеет значение null.

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

-или- to имеет значение Empty ("").

Параметр from или to имеет неправильный формат.

Примеры

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

static void CreateTestMessage2( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the new SMTP client.";
   message->Body = L"Using this new feature, you can send an email message from an application very easily.";
   SmtpClient^ client = gcnew 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;
   client->Send( message );
   client->~SmtpClient();
}
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.

public:
 MailMessage(System::String ^ from, System::String ^ to, System::String ^ subject, System::String ^ body);
public MailMessage (string from, string to, string? subject, 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, содержащее основную часть сообщения.

Исключения

from имеет значение null.

-или- to имеет значение null.

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

-или- to имеет значение Empty ("").

Параметр from или to имеет неправильный формат.

Примеры

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

static void CreateTimeoutTestMessage( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew SmtpClient( server );
   Console::WriteLine( L"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 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 указания различных кодировок.

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