MailAddress Constructeurs

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.

Initialise une nouvelle instance de la classe MailAddress.

Surcharges

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.

MailAddress(String)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: MailAddress.cs

Initialise une nouvelle instance de la classe MailAddress à l’aide de l’adresse spécifiée.

public:
 MailAddress(System::String ^ address);

public MailAddress (string address);

new System.Net.Mail.MailAddress : string -> System.Net.Mail.MailAddress

Public Sub New (address As String)

Paramètres

address: String

String qui contient une adresse e-mail.

Exceptions

ArgumentNullException

address a la valeur null.

ArgumentException

address a la valeur Empty ("").

FormatException

address n’est pas dans un format reconnu.

Exemples

L’exemple de code suivant utilise ce constructeur pour créer un MailAddress objet pour le Bcc destinataire d’un message électronique.

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

public static void CreateBccTestMessage(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.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

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

Remarques

Le address paramètre peut contenir un nom d’affichage et l’adresse e-mail associée si vous placez l’adresse entre crochets. Exemple :

"Tom Smith <tsmith@contoso.com>"

L’espace blanc est autorisé entre le nom d’affichage et les crochets d’angle.

Le tableau suivant montre les valeurs de propriété d’un MailAddress objet construit à l’aide de l’exemple d’adresse précédent.

Property	Valeur
DisplayName	`"Tom Smith"`
Host	`"contoso.com"`
User	`"tsmith"`
Address	`"tsmith@contoso.com"`

S’applique à

MailAddress(String, String)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: MailAddress.cs

Initialise une nouvelle instance de la classe MailAddress à l’aide de l’adresse et du nom complet spécifiés.

public:
 MailAddress(System::String ^ address, System::String ^ displayName);

public MailAddress (string address, string? displayName);

public MailAddress (string address, string displayName);

new System.Net.Mail.MailAddress : string * string -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String)

Paramètres

address: String

String qui contient une adresse e-mail.

displayName: String

String qui continent le nom d’affichage associé à address. Ce paramètre peut être null.

Exceptions

ArgumentNullException

address a la valeur null.

ArgumentException

address a la valeur Empty ("").

FormatException

address n’est pas dans un format reconnu.

- ou -

address contient des caractères non ASCII.

Exemples

L’exemple de code suivant utilise ce constructeur pour créer MailAddress des instances pour l’expéditeur et le destinataire d’un message électronique.

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

public static void CreateBccTestMessage(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.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

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

Remarques

Les espaces blancs de début et de fin dans le nom d’affichage sont conservés.

Si displayName contient des caractères non ASCII, le jeu de caractères iso-8859-1 est utilisé pour l’encodage displayName . L’encodage des caractères non ASCII est abordé dans RFC 1522, qui est disponible à l’adresse https://www.ietf.org/.

Si address contient un nom complet et displayName que n’est pas null et n’est pas égal à String.Empty, displayName remplace la valeur spécifiée dans address.

S’applique à

MailAddress(String, String, Encoding)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: MailAddress.cs

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

public:
 MailAddress(System::String ^ address, System::String ^ displayName, System::Text::Encoding ^ displayNameEncoding);

public MailAddress (string address, string? displayName, System.Text.Encoding? displayNameEncoding);

public MailAddress (string address, string displayName, System.Text.Encoding displayNameEncoding);

new System.Net.Mail.MailAddress : string * string * System.Text.Encoding -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String, displayNameEncoding As Encoding)

Paramètres

address: String

String qui contient une adresse e-mail.

displayName: String

String qui contient le nom complet associé à address.

displayNameEncoding: Encoding

Encoding qui définit le jeu de caractères utilisé pour displayName.

Exceptions

ArgumentNullException

address a la valeur null.

-ou-

displayName a la valeur null.

ArgumentException

address a la valeur Empty ("").

- ou -

displayName a la valeur Empty ("").

FormatException

address n’est pas dans un format reconnu.

- ou -

address contient des caractères non ASCII.

Exemples

L’exemple de code suivant utilise ce constructeur pour créer MailAddress des instances pour l’expéditeur d’un message électronique.

// Create a mailing address that includes a UTF8 
// character in the display name.
MailAddress^ from = gcnew MailAddress("jane@contoso.com",
    "Jane " + (wchar_t)0xD8 + " Clayton",
    System::Text::Encoding::UTF8);

// Create a mailing address that includes a UTF8 character
// in the display name.
MailAddress from = new MailAddress("jane@contoso.com",
   "Jane " + (char)0xD8+ " Clayton",
System.Text.Encoding.UTF8);

' Create a mailing address that includes a UTF8 character
' in the display name.
Dim mailFrom As New MailAddress("jane@contoso.com", "Jane " & ChrW(&HD8) & " Clayton", System.Text.Encoding.UTF8)

Remarques

Les espaces blancs de début et de fin dans le nom d’affichage sont conservés.

Si address contient un nom complet et displayName que n’est pas null et n’est pas égal à String.Empty, displayName remplace la valeur spécifiée dans address.

La MailAddress méthode ne case activée pas si le displayName paramètre est valide. Cette méthode supprime les guillemets environnants non affichés par la DisplayName propriété . Les guillemets seront ajoutés avant la transmission, sauf si ASCII ou Unicode est spécifié dans le displayNameEncoding paramètre . L’encodage spécifié dans le displayNameEncoding paramètre est appliqué à la propriété avant la DisplayName transmission ASCII ou Unicode est spécifié dans le displayNameEncoding paramètre . UTF8 est l’encodage par défaut si aucun n’est spécifié.

Pour plus d’informations sur les formats d’adresse de messagerie pris en charge, consultez MailAddress.

S’applique à

MailAddress Constructeurs

Définition

Surcharges

MailAddress(String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

MailAddress(String, String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

MailAddress(String, String, Encoding)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Commentaires

Ressources supplémentaires