SmtpClient.Host Propriété

Définition

Espace de noms:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Source:

SmtpClient.cs

Obtient ou définit le nom ou l'adresse IP de l'hôte utilisé pour les transactions SMTP.

public:
 property System::String ^ Host { System::String ^ get(); void set(System::String ^ value); };

public string? Host { get; set; }

member this.Host : string with get, set

Public Property Host As String

Valeur de propriété

String

String qui contient le nom ou l'adresse IP de l'ordinateur à utiliser pour les transactions SMTP.

Exceptions

ArgumentNullException

La valeur spécifiée pour une opération set est null.

ArgumentException

La valeur spécifiée pour une opération set est égale à Empty ("").

InvalidOperationException

Vous ne pouvez pas modifier la valeur de cette propriété lorsqu'un message électronique est en cours d'envoi.

Exemples

L’exemple de code suivant illustre l’envoi d’un message électronique à l’aide de l’hôte et du port spécifiés dans un fichier de configuration d’application.

static void CreateTestMessage4( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailAddress^ to = gcnew MailAddress( L"Jane@contoso.com" );
   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.";
   SmtpClient^ client = gcnew SmtpClient( server );
   Console::WriteLine( L"Sending an email message to {0} by using SMTP host {1} port {2}.", to, client->Host, client->Port );
   client->Send( message );
   client->~SmtpClient();
}

public static void CreateTestMessage4(string server)
{
    MailAddress from = new MailAddress("ben@contoso.com");
    MailAddress to = new MailAddress("Jane@contoso.com");
    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.";
    SmtpClient client = new SmtpClient(server);
    Console.WriteLine("Sending an email message to {0} by using SMTP host {1} port {2}.",
         to.ToString(), client.Host, client.Port);

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

Remarques

La valeur de la propriété peut également être définie à l’aide Host de constructeurs ou du fichier de configuration de l’application ou de la machine. Pour plus d’informations, consultez <élément mailSettings> (paramètres réseau).

Si des informations sont spécifiées à l’aide de cette propriété, ces informations remplacent les paramètres du fichier de configuration.

Voir aussi

• SmtpSection
• SmtpNetworkElement
• Host
• Port
• mailSettings pour system.net
• <smtp>, élément (paramètres réseau)
• <network> , élément (paramètres réseau)