MailDefinition.CreateMailMessage Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un e-mail à envoyer via SMTP (Protocole de transfert de courrier simple).
Surcharges
| Nom | Description |
|---|---|
| CreateMailMessage(String, IDictionary, Control) |
Crée un e-mail à partir d’un fichier texte à envoyer via SMTP (Simple Mail Transfer Protocol). |
| CreateMailMessage(String, IDictionary, String, Control) |
Crée un e-mail avec des remplacements à partir d’un fichier texte à envoyer par le biais du protocole SMTP (Simple Mail Transfer Protocol). |
CreateMailMessage(String, IDictionary, Control)
Crée un e-mail à partir d’un fichier texte à envoyer via 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.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessageParamètres
- recipients
- String
Liste séparée par des virgules des destinataires du message.
- replacements
- IDictionary
Contenant IDictionary une liste de chaînes et leurs chaînes de remplacement.
- owner
- Control
Le Control propriétaire de ce MailDefinition.
Retours
Message électronique à partir d’un fichier texte.
Exceptions
replacements ne contient pas de chaînes.
La From valeur de la section SMTP du fichier de configuration est null ou la chaîne vide
- ou -
recipients contient une adresse e-mail incorrecte.
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%>») 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 MailMessage objet 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 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
S’applique à
CreateMailMessage(String, IDictionary, String, Control)
Crée un e-mail avec des remplacements à partir d’un fichier texte à envoyer par le biais 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.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, body As String, owner As Control) As MailMessageParamètres
- recipients
- String
Liste séparée par des virgules des destinataires.
- replacements
- IDictionary
Contenant IDictionary une liste de chaînes et leurs chaînes de remplacement.
- body
- String
Texte du message électronique.
- owner
- Control
Le Control propriétaire de ce MailDefinition.
Retours
Message électronique avec remplacements à partir d’un fichier texte.
Exceptions
replacements ne contient pas de chaînes.
La From valeur de la section SMTP du fichier de configuration est null ou une chaîne vide ( » « ).
- ou -
recipients contient une adresse e-mail incorrecte.
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%>») 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 TextBox contrôle sur une 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 MailMessage objet 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 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é.
