SmtpClient Constructeurs

Définition

Espace de noms:

System.Net.Mail

Assemblys:

netstandard.dll, System.Net.Mail.dll

Initialise une nouvelle instance de la classe SmtpClient.

Surcharges

Nom	Description
SmtpClient()	Initialise une nouvelle instance de la classe à l’aide SmtpClient des paramètres du fichier de configuration.
SmtpClient(String)	Initialise une nouvelle instance de la SmtpClient classe qui envoie un e-mail à l’aide du serveur SMTP spécifié.
SmtpClient(String, Int32)	Initialise une nouvelle instance de la SmtpClient classe qui envoie un e-mail à l’aide du serveur SMTP et du port spécifiés.

SmtpClient()

Source:

SmtpClient.cs

Initialise une nouvelle instance de la classe à l’aide SmtpClient des paramètres du fichier de configuration.

public:
 SmtpClient();

public SmtpClient();

Public Sub New ()

Exemples

L’exemple de code suivant illustre l’envoi d’un message électronique.

public static void CreateTestMessage3()
{
    MailAddress to = new MailAddress("jane@contoso.com");
    MailAddress from = new MailAddress("ben@contoso.com");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    // Use the application or machine configuration to get the
    // host, port, and credentials.
    SmtpClient client = new SmtpClient();
    Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.",
        to.User, to.Host, client.Host);
    client.Send(message);
}

Pour obtenir un exemple du <nœud mailSettings> dans le fichier de configuration de l’application ou de l’ordinateur, consultez <l’élément mailSettings> (paramètres réseau).

Remarques

Ce constructeur initialise les propriétés et CredentialsPort les Hostpropriétés du nouveau SmtpClient en utilisant les paramètres dans les fichiers de configuration de l’application ou de l’ordinateur. Pour plus d’informations, consultez <l’élément mailSettings> (Paramètres réseau).

SmtpClient(String)

Source:

SmtpClient.cs

Initialise une nouvelle instance de la SmtpClient classe qui envoie un e-mail à l’aide du serveur SMTP spécifié.

public:
 SmtpClient(System::String ^ host);

public SmtpClient(string? host);

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

Public Sub New (host As String)

Paramètres

host

String

Qui String contient le nom ou l’adresse IP de l’ordinateur hôte utilisé pour les transactions SMTP.

Exemples

L’exemple de code suivant illustre l’appel de ce constructeur.

public static void CreateTimeoutTestMessage(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server);
    Console.WriteLine("Changing time out from {0} to 100.", client.Timeout);
    client.Timeout = 100;
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Remarques

Le host paramètre est utilisé pour initialiser la valeur de la Host propriété. Les Credentials propriétés et Port les propriétés sont initialisées à l’aide des paramètres dans les fichiers de configuration de l’application ou de l’ordinateur. Si host elle est null ou égale à , Host est initialisée à String.Emptyl’aide des paramètres dans les fichiers de configuration de l’application ou de l’ordinateur.

Pour plus d’informations sur l’utilisation des fichiers de configuration de l’application et de l’ordinateur, consultez <mailSettings> , élément (paramètres réseau). Si des informations sont spécifiées à l’aide SmtpClient de constructeurs ou de propriétés, ces informations remplacent les paramètres du fichier de configuration.

SmtpClient(String, Int32)

Source:

SmtpClient.cs

Initialise une nouvelle instance de la SmtpClient classe qui envoie un e-mail à l’aide du serveur SMTP et du port spécifiés.

public:
 SmtpClient(System::String ^ host, int port);

public SmtpClient(string? host, int port);

new System.Net.Mail.SmtpClient : string * int -> System.Net.Mail.SmtpClient

Public Sub New (host As String, port As Integer)

Paramètres

host

String

Qui String contient le nom ou l’adresse IP de l’hôte utilisé pour les transactions SMTP.

port

Int32

Supérieur Int32 à zéro qui contient le port à utiliser sur host.

Exceptions

ArgumentOutOfRangeException

port ne peut pas être inférieur à zéro.

Exemples

L’exemple de code suivant illustre l’appel de ce constructeur.

public static void CreateTestMessage1(string server, int port)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server, port);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Remarques

Les host paramètres et port les paramètres définissent respectivement la valeur des propriétés et Port des Host propriétés. Si host elle est null ou égale à , Host est initialisée à String.Emptyl’aide des paramètres dans les fichiers de configuration de l’application ou de l’ordinateur. S’il port s’agit de zéro, Port est initialisé à l’aide des paramètres dans les fichiers de configuration de l’application ou de l’ordinateur. La Credentials propriété est initialisée à l’aide des paramètres dans les fichiers de configuration de l’application ou de l’ordinateur.

Pour plus d’informations sur l’utilisation des fichiers de configuration de l’application et de l’ordinateur, consultez <mailSettings> , élément (paramètres réseau). Si des informations sont spécifiées à l’aide SmtpClient de constructeurs ou de propriétés, ces informations remplacent les paramètres du fichier de configuration.