MailAddress Classe

Définition

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

Héritage

Object

MailAddress

Exemples

L’exemple de code suivant illustre l’envoi d’un message électronique à l’aide des classes et MailMessage des SmtpClientMailAddresséléments suivants.

public static void CreateCopyMessage(string server)
{
    MailAddress from = new MailAddress("ben@contoso.com", "Ben Miller");
    MailAddress to = new MailAddress("jane@contoso.com", "Jane Clayton");
    MailMessage message = new MailMessage(from, to);
    // message.Subject = "Using the SmtpClient class.";
    message.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an email message from an application very easily.";
    // Add a carbon copy recipient.
    MailAddress copy = new MailAddress("Notification_List@contoso.com");
    message.CC.Add(copy);
    SmtpClient client = new SmtpClient(server);
    // Include credentials if the server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} by using the SMTP host {1}.",
         to.Address, client.Host);

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateCopyMessage(): {0}",
            ex.ToString());
    }
}

Remarques

La MailAddress classe est utilisée par les classes et MailMessage les SmtpClient classes pour stocker les informations d’adresse pour les messages électroniques.

Une adresse de messagerie est composée d’un nom d’utilisateur, d’un nom d’hôte et d’un nom d’affichage facultatif. DisplayName peut contenir des caractères non ASCII si vous les encoderez.

La MailAddress classe prend en charge les formats d’adresse de messagerie suivants :

• Format d’adresse simple de user@host. S’il DisplayName n’est pas défini, il s’agit du format d’adresse de messagerie généré.

• Format de nom complet entre guillemets standard de "display name" <user@host>. Si un DisplayName jeu est défini, il s’agit du format généré.

  • S’ils ne sont pas déjà inclus, les crochets angle sont ajoutés autour du nom et Host du User nom. Par exemple, "display name" user@host est remplacé par "display name" <user@host>.
  • S’ils ne sont pas déjà inclus, les guillemets sont ajoutés autour du DisplayName. Par exemple, display name <user@host> est remplacé par "display name" <user@host>.
  • Les caractères Unicode sont pris en charge dans la DisplayName propriété.

Dans ces deux formats, les éléments suivants sont autorisés :

• Nom User avec guillemets. Par exemple : "user name"@host.
• Littéraux de domaine entre crochets. Par exemple : <user@[my domain]>.
• Commentaires. Par exemple : (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Les commentaires sont supprimés avant la transmission.
• .NET 9 et versions antérieures UNIQUEMENT : points consécutifs et de fin dans les noms d’utilisateur. Par exemple : user...name..@host. (À partir de .NET 10, les points consécutifs ne sont pas autorisés.)

Une virgule est utilisée pour séparer les éléments d’une liste d’adresses de messagerie. Par conséquent, une virgule ne doit pas être utilisée dans des noms d’affichage non cités dans une liste. Les adresses de messagerie suivantes sont autorisées :

"John, Doe" <user@host>, "Bob, Smith" <user2@host>

L’adresse de messagerie suivante n’est pas autorisée :

John, Doe <user@host>, Bob, Smith <user2@host>

Les guillemets peuvent être incorporés dans une chaîne entre guillemets, mais ils doivent être échappés. Les adresses de messagerie suivantes sont autorisées :

"John \"Jr\" Doe" <user@host>

"\"John \\\"Jr\\\" Doe\" <user@host>"

L’adresse de messagerie suivante n’est pas autorisée :

"John "Jr" Doe" <user@host>

Lorsque le nom d’utilisateur n’est pas entre guillemets, tout le texte entre le début de la chaîne (ou la virgule) et l’adresse est considérée comme faisant partie du DisplayName, y compris les commentaires. Par exemple:

(non comment) unquoted display (non comment) name (non comment) <user@host>

Bien que la MailAddress classe accepte une adresse de messagerie valide, d’autres serveurs de messagerie peuvent ne pas accepter l’adresse de messagerie.

La MailAddress classe ne prend pas en charge les formats d’adresse de messagerie suivants :

• Noms d’affichage entre guillemets et non guillemets mixtes. Par exemple : display "name" <user@host>.
• Groupes, tels que définis dans la section 3.4 de la RFC 2822 publiée par l’IETF.
• Formats de nom d’utilisateur obsolètes de "user"."name"@host, user."name"@host ou "user".name@host.
• .NET 10 et versions ultérieures uniquement : points consécutifs dans le nom d’utilisateur, par exemple, user...name@host.com.