Partager via


MailAddress Constructeurs

Définition

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

address a la valeur null.

address a la valeur Empty ("").

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

address a la valeur null.

address a la valeur Empty ("").

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

address a la valeur null.

-ou-

displayName a la valeur null.

address a la valeur Empty ("").

- ou -

displayName a la valeur Empty ("").

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 à