SmtpClient Costruttori

Definizione

Spazio dei nomi:

System.Net.Mail

Assembly:

netstandard.dll, System.Net.Mail.dll

Inizializza una nuova istanza della classe SmtpClient.

Overload

Nome	Descrizione
SmtpClient()	Inizializza una nuova istanza della SmtpClient classe utilizzando le impostazioni del file di configurazione.
SmtpClient(String)	Inizializza una nuova istanza della SmtpClient classe che invia messaggi di posta elettronica utilizzando il server SMTP specificato.
SmtpClient(String, Int32)	Inizializza una nuova istanza della SmtpClient classe che invia messaggi di posta elettronica utilizzando il server SMTP e la porta specificati.

SmtpClient()

Origine:

SmtpClient.cs

Inizializza una nuova istanza della SmtpClient classe utilizzando le impostazioni del file di configurazione.

public:
 SmtpClient();

public SmtpClient();

Public Sub New ()

Esempio

Nell'esempio di codice seguente viene illustrato l'invio di un messaggio di posta elettronica.

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);
}

Per un esempio del nodo mailSettings nel file di configurazione dell'applicazione o del computer, vedere Elemento mailSettings (Impostazioni di rete).For an example of the <mailSettings> node in the application or machine configuration file, see <mailSettings> Element (Network Settings).

Commenti

Questo costruttore inizializza le Hostproprietà , Credentialse Port per il nuovo SmtpClient usando le impostazioni nei file di configurazione dell'applicazione o del computer. Per altre informazioni, vedere <elemento mailSettings (impostazioni di> rete).

SmtpClient(String)

Origine:

SmtpClient.cs

Inizializza una nuova istanza della SmtpClient classe che invia messaggi di posta elettronica utilizzando il server SMTP specificato.

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)

Parametri

host

String

Oggetto String contenente il nome o l'indirizzo IP del computer host utilizzato per le transazioni SMTP.

Esempio

Nell'esempio di codice seguente viene illustrata la chiamata a questo costruttore.

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);
}

Commenti

Il host parametro viene utilizzato per inizializzare il valore della Host proprietà . Le Credentials proprietà e Port vengono inizializzate usando le impostazioni nei file di configurazione dell'applicazione o del computer. Se host è null o uguale a String.Empty, Host viene inizializzato usando le impostazioni nei file di configurazione dell'applicazione o del computer.

Per altre informazioni sull'uso dei file di configurazione dell'applicazione e del computer, vedere <Elemento mailSettings> (Impostazioni di rete). Se le informazioni vengono specificate utilizzando SmtpClient costruttori o proprietà, queste informazioni sostituiscono le impostazioni del file di configurazione.

SmtpClient(String, Int32)

Origine:

SmtpClient.cs

Inizializza una nuova istanza della SmtpClient classe che invia messaggi di posta elettronica utilizzando il server SMTP e la porta specificati.

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)

Parametri

host

String

Oggetto String contenente il nome o l'indirizzo IP dell'host utilizzato per le transazioni SMTP.

port

Int32

Valore Int32 maggiore di zero che contiene la porta da usare in host.

Eccezioni

ArgumentOutOfRangeException

port non può essere minore di zero.

Esempio

Nell'esempio di codice seguente viene illustrata la chiamata a questo costruttore.

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);
}

Commenti

I host parametri e port impostano rispettivamente il valore delle Host proprietà e Port . Se host è null o uguale a String.Empty, Host viene inizializzato usando le impostazioni nei file di configurazione dell'applicazione o del computer. Se port è zero, Port viene inizializzato usando le impostazioni nei file di configurazione dell'applicazione o del computer. La Credentials proprietà viene inizializzata usando le impostazioni nei file di configurazione dell'applicazione o del computer.

Per altre informazioni sull'uso dei file di configurazione dell'applicazione e del computer, vedere <Elemento mailSettings> (Impostazioni di rete). Se le informazioni vengono specificate utilizzando SmtpClient costruttori o proprietà, queste informazioni sostituiscono le impostazioni del file di configurazione.