MailAddress Classe

Référence

Définition

Espace de noms:: System.Net.Mail

Assembly:: System.Net.Mail.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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.

Représente l'adresse de l'expéditeur ou du destinataire d'un message électronique.

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 SmtpClient MailAddresséléments suivants.

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

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 classes pour stocker les informations d’adresse pour les SmtpClient messages électroniques.

Une adresse de messagerie est composée d’un nom, d’un User nom et éventuellement d’un DisplayName. Host Il DisplayName peut contenir des caractères non ASCII si vous les encodez.

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é.
Les crochets angle sont ajoutés autour du nom et Host du User nom, s’ils ne sont pas inclus. Par exemple, "display name" user@host est remplacé par "display name" <user@host>.
Les guillemets sont ajoutés autour de l’objet DisplayName, s’ils ne sont pas inclus. 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é.
Nom User avec guillemets. Par exemple : "user name"@host.
Points consécutifs et de fin dans les noms d’utilisateur. Par exemple : user...name..@host.
Littéraux de domaine entre crochets. Par exemple : <user@[my domain]>.
Comments : Par exemple : (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Les commentaires sont supprimés avant la transmission.

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 les 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 placés dans une séquence d’échappement. 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 sont considérés comme faisant partie du DisplayNametexte , y compris les commentaires. Exemple :

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

Bien que la MailAddress classe accepte une adresse de messagerie comme 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 complets entre guillemets et non mis en guillemets. Par exemple : display "name" <user@host>.
Groupes, tels que définis dans la section RFC 2822, section 3.4 publiée par l’IETF.
Formats de nom d’utilisateur obsolètes de "user"."name"@host, user."name"@host ou "user".name@host.

Constructeurs

MailAddress(String)	Initialise une nouvelle instance de la classe MailAddress à l’aide de l’adresse spécifiée.
MailAddress(String, String)	Initialise une nouvelle instance de la classe MailAddress à l’aide de l’adresse et du nom complet spécifiés.
MailAddress(String, String, Encoding)	Initialise une nouvelle instance de la classe MailAddress à l'aide de l'adresse, du nom complet et de l'encodage spécifiés.

Propriétés

Address	Obtient l’adresse e-mail spécifiée quand cette instance a été créée.
DisplayName	Obtient le nom complet composé à partir du nom complet et des informations d'adresse spécifiés quand cette instance a été créée.
Host	Obtient la partie hôte de l'adresse spécifiée quand cette instance a été créée.
User	Obtient les informations sur l'utilisateur à partir de l'adresse spécifiée quand cette instance a été créée.

Méthodes

Equals(Object)	Compare deux adresses de messagerie.
GetHashCode()	Retourne une valeur de hachage pour une adresse de messagerie.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une représentation sous forme de chaîne de cette instance.
TryCreate(String, MailAddress)	Crée un MailAddress. Ne lève pas d’exception si l’objet ne peut pas être créé.
TryCreate(String, String, Encoding, MailAddress)	Créez un MailAddress. Ne lève pas d’exception si l’objet ne peut pas être créé.
TryCreate(String, String, MailAddress)	Créez un MailAddress. Ne lève pas d’exception si l’objet ne peut pas être créé.

S’applique à