SmtpClient Constructores

Definición

Espacio de nombres:

System.Net.Mail

Ensamblados:

netstandard.dll, System.Net.Mail.dll

Inicializa una nueva instancia de la clase SmtpClient.

Sobrecargas

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

SmtpClient()

Source:

SmtpClient.cs

Inicializa una nueva instancia de la SmtpClient clase mediante 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.

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 <mailSettings> Element (Network Settings).

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 máquina. Para obtener más información, vea <mailSettings> Element (Network Settings).

SmtpClient(String)

Source:

SmtpClient.cs

Inicializa una nueva instancia de la SmtpClient clase que envía correo electrónico mediante 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

que String contiene el nombre o la dirección IP del equipo host que se usa 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 de la máquina. 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 de la máquina.

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

SmtpClient(String, Int32)

Source:

SmtpClient.cs

Inicializa una nueva instancia de la SmtpClient clase que envía correo electrónico mediante 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

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

port

Int32

Un Int32 valor mayor que cero que contiene el puerto que se va a usar 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.

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 de la máquina. Si port es cero, Port se inicializa mediante 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 de la máquina.

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