MailMessage Constructores

Definición

Espacio de nombres:

System.Net.Mail

Ensamblado:

System.Net.Mail.dll

Inicializa una nueva instancia de la clase MailMessage.

Sobrecargas

MailMessage()	Inicializa una instancia vacía de la clase MailMessage.
MailMessage(MailAddress, MailAddress)	Inicializa una nueva instancia de la clase MailMessage utilizando los objetos especificados de clase MailAddress.
MailMessage(String, String)	Inicializa una nueva instancia de la clase MailMessage utilizando los objetos especificados de clase String.
MailMessage(String, String, String, String)	Inicializa una nueva instancia de la clase MailMessage.

MailMessage()

Source:

MailMessage.cs

Inicializa una instancia vacía de la clase MailMessage.

public:
 MailMessage();

public MailMessage ();

Public Sub New ()

Comentarios

From se establece en el valor del elemento de red para mailSettings<smtp> Element (Network Settings), si existe.

MailMessage(MailAddress, MailAddress)

Source:

MailMessage.cs

Inicializa una nueva instancia de la clase MailMessage utilizando los objetos especificados de clase MailAddress.

public:
 MailMessage(System::Net::Mail::MailAddress ^ from, System::Net::Mail::MailAddress ^ to);

public MailMessage (System.Net.Mail.MailAddress from, System.Net.Mail.MailAddress to);

new System.Net.Mail.MailMessage : System.Net.Mail.MailAddress * System.Net.Mail.MailAddress -> System.Net.Mail.MailMessage

Public Sub New (from As MailAddress, to As MailAddress)

Parámetros

from

MailAddress

Elemento MailAddress que contiene la dirección del remitente del mensaje de correo electrónico.

to

MailAddress

Elemento MailAddress que contiene la dirección del destinatario del mensaje de correo electrónico.

Excepciones

ArgumentNullException

from es null.

o bien

to es null.

FormatException

El parámetro from o el parámetro to es incorrecto.

Ejemplos

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

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

Public Shared Sub CreateTestMessage3()
    Dim [to] As MailAddress = New MailAddress("jane@contoso.com")
    Dim from As MailAddress = New MailAddress("ben@contoso.com")
    Dim message As MailMessage = 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.
    Dim client As SmtpClient = 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)
End Sub

Comentarios

La From propiedad se inicializa mediante from y la To propiedad se inicializa mediante to.

MailMessage(String, String)

Source:

MailMessage.cs

Inicializa una nueva instancia de la clase MailMessage utilizando los objetos especificados de clase String.

public:
 MailMessage(System::String ^ from, System::String ^ to);

public MailMessage (string from, string to);

new System.Net.Mail.MailMessage : string * string -> System.Net.Mail.MailMessage

Public Sub New (from As String, to As String)

Parámetros

from

String

Elemento String que contiene la dirección del remitente del mensaje de correo electrónico.

to

String

Elemento String que contiene las direcciones de los destinatarios del mensaje de correo electrónico. Si se usan varias direcciones de correo electrónico, es necesario separarlas con un carácter de coma (“,”).

Excepciones

ArgumentNullException

from es null.

o bien

to es null.

ArgumentException

from es Empty ("").

o bien

to es Empty ("").

FormatException

El parámetro from o el parámetro to es incorrecto.

Ejemplos

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

static void CreateTestMessage2( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = 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.";
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Credentials are necessary if the server requires the client 
   // to authenticate before it will send email on the client's behalf.
   client->UseDefaultCredentials = true;
   client->Send( message );
   client->~SmtpClient();
}

public static void CreateTestMessage2(string server)
{
    string to = "jane@contoso.com";
    string from = "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.";
    SmtpClient client = new SmtpClient(server);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = true;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateTestMessage2(): {0}",
            ex.ToString());
    }
}

Public Shared Sub CreateTestMessage2(ByVal server As String)
    Dim [to] As String = "jane@contoso.com"
    Dim from As String = "ben@contoso.com"
    Dim message As MailMessage = 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."
    Dim client As SmtpClient = New SmtpClient(server)
    ' Credentials are necessary if the server requires the client
    ' to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = True

    Try
        client.Send(message)
    Catch ex As Exception
        Console.WriteLine("Exception caught in CreateTestMessage2(): {0}", ex.ToString())
    End Try
End Sub

Comentarios

La From propiedad se inicializa mediante from y la To propiedad se inicializa mediante to.

MailMessage(String, String, String, String)

Source:

MailMessage.cs

Inicializa una nueva instancia de la clase MailMessage.

public:
 MailMessage(System::String ^ from, System::String ^ to, System::String ^ subject, System::String ^ body);

public MailMessage (string from, string to, string? subject, string? body);

new System.Net.Mail.MailMessage : string * string * string * string -> System.Net.Mail.MailMessage

Public Sub New (from As String, to As String, subject As String, body As String)

Parámetros

from

String

Elemento String que contiene la dirección del remitente del mensaje de correo electrónico.

to

String

Elemento String que contiene las direcciones de los destinatarios del mensaje de correo electrónico. Si se usan varias direcciones de correo electrónico, es necesario separarlas con un carácter de coma (“,”).

subject

String

Objeto String que contiene el texto del asunto.

body

String

Objeto String que contiene el cuerpo del mensaje.

Excepciones

ArgumentNullException

from es null.

o bien

to es null.

ArgumentException

from es Empty ("").

o bien

to es Empty ("").

FormatException

El parámetro from o el parámetro to es incorrecto.

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

Public Shared Sub CreateTimeoutTestMessage(ByVal server As String)
    Dim [to] As String = "jane@contoso.com"
    Dim from As String = "ben@contoso.com"
    Dim subject As String = "Using the new SMTP client."
    Dim body As String = "Using this new feature, you can send an email message from an application very easily."
    Dim message As MailMessage = New MailMessage(from, [to], subject, body)
    Dim client As SmtpClient = 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)
End Sub

Comentarios

Las propiedades del nuevo MailMessage objeto se inicializan de la siguiente manera:

Parámetro	Propiedad.
from	From
to	To
subject	Subject
body	Body

De forma predeterminada, se supone que el asunto y el contenido usan la codificación predeterminada en función de la configuración del equipo local. Use las BodyEncoding propiedades y SubjectEncoding para especificar diferentes codificaciones.