Partager via


MailMessage Constructeurs

Définition

Initialise une nouvelle instance de la classe MailMessage.

Surcharges

MailMessage()

Initialise une instance vide de la classe MailMessage.

MailMessage(MailAddress, MailAddress)

Initialise une nouvelle instance de la classe MailMessage en utilisant les objets de classe MailAddress spécifiés.

MailMessage(String, String)

Initialise une nouvelle instance de la classe MailMessage en utilisant les objets de classe String spécifiés.

MailMessage(String, String, String, String)

Initialise une nouvelle instance de la classe MailMessage.

MailMessage()

Source:
MailMessage.cs
Source:
MailMessage.cs
Source:
MailMessage.cs

Initialise une instance vide de la classe MailMessage.

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

Remarques

De est défini sur la valeur dans l’élément réseau pourl’élément smtp> mailSettings<(paramètres réseau), s’il existe.

S’applique à

MailMessage(MailAddress, MailAddress)

Source:
MailMessage.cs
Source:
MailMessage.cs
Source:
MailMessage.cs

Initialise une nouvelle instance de la classe MailMessage en utilisant les objets de classe MailAddress spécifiés.

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)

Paramètres

from
MailAddress

MailAddress qui contient l’adresse de l’expéditeur de l’e-mail.

to
MailAddress

MailAddress qui contient l’adresse du destinataire de l’e-mail.

Exceptions

from a la valeur null.

-ou-

to a la valeur null.

from ou to est formé de manière incorrecte.

Exemples

L’exemple de code suivant illustre l’appel de ce constructeur.

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

Remarques

La From propriété est initialisée à l’aide from de et la To propriété est initialisée à l’aide tode .

S’applique à

MailMessage(String, String)

Source:
MailMessage.cs
Source:
MailMessage.cs
Source:
MailMessage.cs

Initialise une nouvelle instance de la classe MailMessage en utilisant les objets de classe String spécifiés.

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)

Paramètres

from
String

String qui contient l’adresse de l’expéditeur de l’e-mail.

to
String

String qui contient les adresses des destinataires de l’e-mail. Plusieurs adresses e-mail doivent être séparées avec une virgule (",").

Exceptions

from a la valeur null.

-ou-

to a la valeur null.

from a la valeur Empty ("").

- ou -

to a la valeur Empty ("").

from ou to est formé de manière incorrecte.

Exemples

L’exemple de code suivant illustre l’appel de ce constructeur.

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

Remarques

La From propriété est initialisée à l’aide from de et la To propriété est initialisée à l’aide tode .

S’applique à

MailMessage(String, String, String, String)

Source:
MailMessage.cs
Source:
MailMessage.cs
Source:
MailMessage.cs

Initialise une nouvelle instance de la classe 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)

Paramètres

from
String

String qui contient l’adresse de l’expéditeur de l’e-mail.

to
String

String qui contient les adresses des destinataires de l’e-mail. Plusieurs adresses e-mail doivent être séparées avec une virgule (",").

subject
String

String qui contient le texte de l'objet.

body
String

String qui contient le corps du message.

Exceptions

from a la valeur null.

-ou-

to a la valeur null.

from a la valeur Empty ("").

- ou -

to a la valeur Empty ("").

from ou to est formé de manière incorrecte.

Exemples

L’exemple de code suivant illustre l’appel de ce constructeur.

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

Remarques

Les propriétés du nouvel MailMessage objet sont initialisées comme suit :

Paramètre Propriété
from From
to To
subject Subject
body Body

Par défaut, l’objet et le contenu sont supposés utiliser l’encodage par défaut en fonction des paramètres de l’ordinateur local. Utilisez les BodyEncoding propriétés et SubjectEncoding pour spécifier différents encodages.

S’applique à