MailDefinition.CreateMailMessage Méthode

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Crée un e-mail à envoyer au moyen du protocole SMTP (Simple Mail Transfer Protocol).

Surcharges

CreateMailMessage(String, IDictionary, Control)	Crée un e-mail à partir d’un fichier texte à envoyer au moyen du protocole SMTP (Simple Mail Transfer Protocol).
CreateMailMessage(String, IDictionary, String, Control)	Crée un e-mail avec les remplacements provenant d’un fichier texte à envoyer au moyen du protocole SMTP (Simple Mail Transfer Protocol).

CreateMailMessage(String, IDictionary, Control)

Crée un e-mail à partir d’un fichier texte à envoyer au moyen du protocole SMTP (Simple Mail Transfer Protocol).

public:
 System::Net::Mail::MailMessage ^ CreateMailMessage(System::String ^ recipients, System::Collections::IDictionary ^ replacements, System::Web::UI::Control ^ owner);

public System.Net.Mail.MailMessage CreateMailMessage (string recipients, System.Collections.IDictionary replacements, System.Web.UI.Control owner);

member this.CreateMailMessage : string * System.Collections.IDictionary * System.Web.UI.Control -> System.Net.Mail.MailMessage

Public Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessage

Paramètres

recipients

String

Liste des destinataires du message séparés par une virgule.

replacements

IDictionary

IDictionary contenant une liste de chaînes et leurs chaînes de remplacement.

owner

Control

Control qui possède ce MailDefinition.

Retours

MailMessage

E-mail à partir d’un fichier texte.

Exceptions

ArgumentException

replacements ne contient pas de chaînes.

HttpException

La valeur From dans la section SMTP du fichier de configuration est null ou la chaîne vide.

• ou -

recipients contient une adresse e-mail incorrecte.

ArgumentNullException

owner a la valeur null.

Exemples

L’exemple de code suivant crée un ListDictionary objet qui définit deux chaînes («<%To%> » et «<%From%> ») qui sont remplacées dans le message électronique.

Cet exemple de code fait partie d’un exemple plus grand fourni pour la MailDefinition classe.

ListDictionary replacements = new ListDictionary();
replacements.Add("<%To%>",sourceTo.Text);
replacements.Add("<%From%>", md.From);

Dim replacements As ListDictionary = New ListDictionary
replacements.Add("<%To%>", sourceTo.Text)
replacements.Add("<%From%>", sourceFrom.Text)

L’exemple de code suivant utilise la CreateMailMessage méthode pour créer un message électronique à partir d’un fichier texte.

Cet exemple de code fait partie d’un exemple plus grand fourni pour la MailDefinition classe.

System.Net.Mail.MailMessage fileMsg;
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, this); 

Dim fileMsg As System.Net.Mail.MailMessage
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, Me)

Remarques

La CreateMailMessage méthode crée un objet MailMessage qui peut être envoyé à l’aide de la SmtpClient.Send méthode.

La BodyFormat propriété doit être définie pour indiquer si le message électronique doit être mis en forme en texte brut (MailFormat.Text) ou HTML (MailFormat.Html).

Le recipients paramètre contient une liste séparée par des virgules des destinataires du message électronique. Si le recipients paramètre contient une adresse e-mail Internet mal mise en forme, la Send méthode lève une HttpException exception et le message électronique n’est pas envoyé.

Le replacements paramètre est une IDictionary instance qui contient une liste de chaînes à remplacer. Les chaînes sont remplacées dans l’ordre dans lequel elles ont été ajoutées à la IDictionary collection, et elles peuvent remplacer les remplacements antérieurs.

Le owner paramètre indique quel contrôle est le parent du MailDefinition contrôle. Il détermine le répertoire à rechercher dans le fichier texte spécifié dans la BodyFileName propriété.

Voir aussi

• SmtpClient
• MailMessage
• EmbeddedMailObject

CreateMailMessage(String, IDictionary, String, Control)

Crée un e-mail avec les remplacements provenant d’un fichier texte à envoyer au moyen du protocole SMTP (Simple Mail Transfer Protocol).

public:
 System::Net::Mail::MailMessage ^ CreateMailMessage(System::String ^ recipients, System::Collections::IDictionary ^ replacements, System::String ^ body, System::Web::UI::Control ^ owner);

public System.Net.Mail.MailMessage CreateMailMessage (string recipients, System.Collections.IDictionary replacements, string body, System.Web.UI.Control owner);

member this.CreateMailMessage : string * System.Collections.IDictionary * string * System.Web.UI.Control -> System.Net.Mail.MailMessage

Public Function CreateMailMessage (recipients As String, replacements As IDictionary, body As String, owner As Control) As MailMessage

Paramètres

recipients

String

Liste des destinataires séparés par des virgules.

replacements

IDictionary

IDictionary contenant une liste de chaînes et leurs chaînes de remplacement.

body

String

Texte de l’e-mail.

owner

Control

Control qui possède ce MailDefinition.

Retours

MailMessage

E-mail avec les remplacements à partir d’un fichier texte.

Exceptions

ArgumentException

replacements ne contient pas de chaînes.

HttpException

La valeur From dans la section SMTP du fichier de configuration est null ou une chaîne vide ("").

• ou -

recipients contient une adresse e-mail incorrecte.

ArgumentNullException

owner a la valeur null.

Exemples

L’exemple de code suivant crée un ListDictionary objet qui définit deux chaînes («<%To%> » et «<%From%> ») qui sont remplacées dans le message électronique.

Cet exemple de code fait partie d’un exemple plus grand fourni pour la MailDefinition classe.

ListDictionary replacements = new ListDictionary();
replacements.Add("<%To%>",sourceTo.Text);
replacements.Add("<%From%>", md.From);

Dim replacements As ListDictionary = New ListDictionary
replacements.Add("<%To%>", sourceTo.Text)
replacements.Add("<%From%>", sourceFrom.Text)

L’exemple de code suivant utilise la CreateMailMessage méthode pour créer un message électronique à partir du texte entré dans un contrôle sur une TextBox page Web Forms.

Cet exemple de code fait partie d’un exemple plus grand fourni pour la MailDefinition classe.

System.Net.Mail.MailMessage fileMsg;
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, this); 

Dim fileMsg As System.Net.Mail.MailMessage
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, Me)

Remarques

La CreateMailMessage méthode crée un objet MailMessage qui peut être envoyé avec la SmtpClient.Send méthode.

Le recipients paramètre contient une liste séparée par des virgules des destinataires du message électronique. Si le recipients paramètre contient une adresse e-mail Internet mal mise en forme, la Send méthode lève une HttpException exception et le message électronique n’est pas envoyé.

Le replacements paramètre est une IDictionary instance qui contient une liste de chaînes à remplacer. Les chaînes sont remplacées dans l’ordre dans lequel elles ont été ajoutées à la IDictionary collection, et elles peuvent remplacer les remplacements antérieurs.

Le body paramètre contient le texte du message électronique.

Le owner paramètre indique quel contrôle est le parent du MailDefinition contrôle. Il détermine le répertoire à rechercher dans le fichier texte spécifié dans la BodyFileName propriété.

Voir aussi

• SmtpClient
• MailMessage
• EmbeddedMailObject