SmtpClient Constructores

Definición

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
Source:
SmtpClient.cs
Source:
SmtpClient.cs

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

public SmtpClient ();

Ejemplos

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

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

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

SmtpClient(String)

Source:
SmtpClient.cs
Source:
SmtpClient.cs
Source:
SmtpClient.cs

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

public SmtpClient (string? host);
public SmtpClient (string host);

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.

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.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

SmtpClient(String, Int32)

Source:
SmtpClient.cs
Source:
SmtpClient.cs
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 (string? host, int port);
public SmtpClient (string host, int port);

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

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.

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.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1