SmtpClient Constructores

Definición

Espacio de nombres:

System.Net.Mail

Ensamblado:

System.Net.Mail.dll

Inicializa una nueva instancia de la clase SmtpClient.

Sobrecargas

SmtpClient()	Inicializa una nueva instancia de la clase SmtpClient usando la configuración del archivo de configuración.
SmtpClient(String)	Inicializa una nueva instancia de la clase SmtpClient que envía correo electrónico con el servidor SMTP especificado.
SmtpClient(String, Int32)	Inicializa una nueva instancia de la clase SmtpClient que envía correo electrónico con el servidor SMTP y el puerto especificados.

SmtpClient()

Source:

SmtpClient.cs

Inicializa una nueva instancia de la clase SmtpClient usando la configuración del archivo de configuración.

public:
 SmtpClient();

public SmtpClient ();

Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se muestra cómo enviar un mensaje de correo electrónico.

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

Para obtener un ejemplo del <nodo mailSettings> en el archivo de configuración de la aplicación o máquina, vea <elemento mailSettings> (Configuración de red).

Comentarios

Este constructor inicializa las Hostpropiedades , Credentialsy Port para el nuevo SmtpClient mediante la configuración de los archivos de configuración de la aplicación o del equipo. Para obtener más información, vea <elemento mailSettings> (Configuración de red) .

SmtpClient(String)

Source:

SmtpClient.cs

Inicializa una nueva instancia de la clase SmtpClient que envía correo electrónico con el servidor SMTP especificado.

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)

Parámetros

host

String

Objeto String que contiene el nombre o la dirección IP del equipo host utilizado para las transacciones SMTP.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este constructor.

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

Comentarios

El host parámetro se usa para inicializar el valor de la Host propiedad . Las Credentials propiedades y Port se inicializan mediante la configuración de los archivos de configuración de la aplicación o del equipo. Si host es null o igual a String.Empty, Host se inicializa mediante la configuración de los archivos de configuración de la aplicación o del equipo.

Para obtener más información sobre el uso de los archivos de configuración de la aplicación y la máquina, vea <elemento mailSettings> (Configuración de red). Si se especifica información mediante SmtpClient constructores o propiedades, esta información invalida los valores del archivo de configuración.

SmtpClient(String, Int32)

Source:

SmtpClient.cs

Inicializa una nueva instancia de la clase SmtpClient que envía correo electrónico con el servidor SMTP y el puerto especificados.

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)

Parámetros

host

String

Objeto String que contiene el nombre o la dirección IP del host utilizado para las transacciones SMTP.

port

Int32

Valor Int32 mayor que cero que contiene el puerto que se va a utilizar en host.

Excepciones

ArgumentOutOfRangeException

El parámetro port no puede ser menor que cero.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este constructor.

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

Comentarios

Los host parámetros y port establecen el valor de las Host propiedades y Port , respectivamente. Si host es null o igual a String.Empty, Host se inicializa mediante la configuración de los archivos de configuración de la aplicación o del equipo. Si port es cero, Port se inicializa con la configuración de los archivos de configuración de la aplicación o de la máquina. La Credentials propiedad se inicializa mediante la configuración de los archivos de configuración de la aplicación o del equipo.

Para obtener más información sobre el uso de los archivos de configuración de la aplicación y la máquina, vea <elemento mailSettings> (Configuración de red). Si se especifica información mediante SmtpClient constructores o propiedades, esta información invalida los valores del archivo de configuración.