ASP.NET Web Pages - Objet WebMail

Grâce à l'objet WebMail, vous pouvez envoyer des e-mails facilement depuis une page Web.

Description

WebMail fournit une méthode simple pour construire et envoyer des e-mails en utilisant le protocole de transmission de courrier électronique (SMTP).

Exemple

Veuillez consulter Pages Web Courriel Exemples de cette section.

Manuel de référence des objets WebMail - Propriétés

Propriété Description
EnableSsl True, si le serveur utilise le chiffrement SSL.
From Obtient ou définit l'adresse électronique de l'expéditeur.
Password Obtient ou définit le mot de passe du compte de messagerie électronique de l'expéditeur.
SmtpPort Obtient ou définit le port utilisé pour les transactions SMTP.
SmtpServer Obtient ou définit le nom du serveur SMTP utilisé pour transmettre des e-mails.
UserName Obtient ou définit le nom de compte de messagerie électronique utilisé pour envoyer des e-mails.

Manuel de référence WebMail - Méthode

Méthode Description
Send() Envoie le courriel spécifié au serveur SMTP de transfert.

La méthode Send() a les paramètres suivants :

Paramètres Type Description
to Chaîne Adresse du destinataire. Séparées par des points-virgules (;).
subject Chaîne Ligne de sujet.
body Chaîne Corps de l'e-mail.

et les paramètres optionnels suivants :

Paramètres Type Description
from Chaîne Adresse de l'expéditeur.
cc Chaîne Adresse auxquelles vous souhaitez copier le courriel; séparées par des points-virgules (;).
filesToAttach Collection Collection de noms de fichiers, utilisés pour spécifier les fichiers à joindre à l'e-mail.
isBodyHtml Valeur logique Si true, spécifie que le corps du courriel est au format HTML.
additionalHeaders Collection En-tête de collection, qui peut être ajouté aux en-têtes SMTP normaux contenus dans cet e-mail.
bcc Chaîne Adresse électronique d'autres destinataires auxquels vous souhaitez envoyer une copie cachée du courriel.
contentEncoding Chaîne Encodage utilisé pour le corps du courriel.
headerEncoding Chaîne Encodage utilisé pour le titre du courriel.
priority Chaîne Valeur utilisée pour spécifier la priorité du courriel.
replyTo Chaîne Adresse électronique utilisée pour répondre aux e-mails du destinataire.

Données techniques

Nom Valeur
Class System.Web.Helpers.WebMail
Namespace System.Web.Helpers
Assembly System.Web.Helpers.dll

Initialiser l'assistant WebMail

Pour utiliser l'assistant WebMail, vous devez accéder à un serveur SMTP. SMTP est la partie "sortie" des e-mails. Si vous utilisez un hébergeur web, vous pourriez déjà avoir le nom du serveur SMTP. Si vous êtes dans un réseau d'entreprise, vous devez demander au service informatique le nom du serveur SMTP. Si vous travaillez à domicile, vous pouvez utiliser un fournisseur de services de messagerie électronique ordinaire.

Pour envoyer des e-mails, vous avez besoin de :

  • Nom du serveur SMTP
  • Port (généralement 25)
  • Nom d'utilisateur e-mail
  • Mot de passe e-mail

Dans le répertoire racine du site, créez (ou éditez) une page nommée _AppStart.cshtml :

Écrivez le code suivant dans ce fichier :

_AppStart.cshtml

@}
WebMail.SmtpServer = "smtp.example.com";
WebMail.SmtpPort = 25;
WebMail.EnableSsl = false;
WebMail.UserName = "support@example.com";
WebMail.Password = "password";
WebMail.From = "john@example.com"
}

Le site (application) exécute le code suivant à chaque démarrage. Il configure Objet WebMailPour l'initialisation.

Remplacez par :

smtp.example.com Pour le nom du serveur SMTP utilisé pour envoyer des e-mails.

25 Pour le port que le serveur utilisera pour traiter les transactions SMTP (e-mails).

false Pour true, si le serveur utilise le protocole de couche de socket sécurisé (SSL) pour chiffrer la connexion lors de l'envoi d'e-mails.

support@example.com Pour le nom de l'adresse électronique utilisé pour envoyer des e-mails.

mot de passe Pour le mot de passe du compte de messagerie SMTP.

john@example Pour l'adresse de l'expéditeur.

Astuce :Vous n'êtes pas obligé d'initialiser l'objet WebMail dans le fichier AppStart, mais vous devez configurer ces propriétés avant d'appeler la méthode WebMail.Send().