SmtpClient Costruttori

Definizione

Spazio dei nomi:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Inizializza una nuova istanza della classe SmtpClient.

Overload

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

SmtpClient()

Origine:

SmtpClient.cs

Inizializza una nuova istanza della classe SmtpClient tramite 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.

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

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 utilizzando le impostazioni nei file di configurazione dell'applicazione o del computer. Per altre informazioni, vedere Elemento mailSettings (impostazioni di rete).For more information, see< mailSettings> Element (Network Settings).

SmtpClient(String)

Origine:

SmtpClient.cs

Inizializza una nuova istanza della classe SmtpClient che invia la posta elettronica mediante 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

Classe 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.

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

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).For more information about using the application and machine configuration files, see <mailSettings> Element (Network Settings). Se le informazioni vengono specificate usando SmtpClient costruttori o proprietà, queste informazioni sostituiscono le impostazioni del file di configurazione.

SmtpClient(String, Int32)

Origine:

SmtpClient.cs

Inizializza una nuova istanza della classe SmtpClient che invia la posta elettronica usando la porta e il server SMTP 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

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

port

Int32

Struttura Int32 maggiore di zero che contiene la porta da utilizzare nell'host.

Eccezioni

ArgumentOutOfRangeException

port non può essere minore di zero.

Esempio

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

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

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).For more information about using the application and machine configuration files, see <mailSettings> Element (Network Settings). Se le informazioni vengono specificate usando SmtpClient costruttori o proprietà, queste informazioni sostituiscono le impostazioni del file di configurazione.