MailAddress Classe

Définition

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
MailAddress

Exemples

L’exemple de code suivant illustre l’envoi d’un message électronique à l’aide des SmtpClientclasses , MailAddresset MailMessage .

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

Une adresse de messagerie est composée d’un nom, d’un User nom et éventuellement d’un DisplayName. Host peut DisplayName 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. Si un DisplayName n’est pas défini, il s’agit du format d’adresse de messagerie généré.

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

    • Des crochets sont ajoutés autour du nom et Host du User nom, si ceux-ci ne sont pas inclus. Par exemple, "display name" user@host est remplacé par "display name" <user@host>.

    • Des guillemets sont ajoutés autour du DisplayName, si ceux-ci 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é .

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

  • 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 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 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 virgule) et l’adresse est considéré comme faisant partie de , DisplayNamey 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 d’affichage mixtes entre guillemets et non cités. 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.

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 à