SmtpClient Constructeurs

Définition

Espace de noms:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Initialise une nouvelle instance de la classe SmtpClient.

Surcharges

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

SmtpClient()

Source:

SmtpClient.cs

Initialise une nouvelle instance de la classe SmtpClient en utilisant 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.

static void CreateTestMessage3()
{
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com" );
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the new SMTP client.";
   message->Body = L"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 = gcnew SmtpClient;
   Console::WriteLine( L"Sending an email message to {0} at {1} by using the SMTP host {2}.", to->User, to->Host, client->Host );
   client->Send( message );
}

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ément mailSettings> (paramètres réseau).

Remarques

Ce constructeur initialise les Hostpropriétés , Credentialset Port pour le nouveau SmtpClient à l’aide des paramètres dans les fichiers de configuration de l’application ou de l’ordinateur. Pour plus d’informations, consultez <élément mailSettings> (paramètres réseau).

SmtpClient(String)

Source:

SmtpClient.cs

Initialise une nouvelle instance de la classe SmtpClient qui envoie des e-mails à 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

String qui 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.

static void CreateTimeoutTestMessage( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew SmtpClient( server );
   Console::WriteLine( L"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 );
}

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 sont initialisées à l’aide des paramètres dans les fichiers de configuration de l’application ou de l’ordinateur. Si host est null égal ou égal à , Host est initialisé à 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 <élément mailSettings> (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 classe SmtpClient qui envoie des e-mails à 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

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

port

Int32

Int32 supérieur à 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.

static void CreateTestMessage1( String^ server, int port )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew 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 );
   client->~SmtpClient();
}

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 définissent respectivement la Host valeur des propriétés et Port . Si host est null égal ou égal à , Host est initialisé à String.Emptyl’aide des paramètres dans les fichiers de configuration de l’application ou de l’ordinateur. Si port est 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 <élément mailSettings> (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.