MailMessage Costruttori

Definizione

Spazio dei nomi:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Inizializza una nuova istanza della classe MailMessage.

Overload

MailMessage()	Inizializza un'istanza vuota della classe MailMessage.
MailMessage(MailAddress, MailAddress)	Inizializza una nuova istanza della classe MailMessage utilizzando gli oggetti della classe MailAddress specificata.
MailMessage(String, String)	Inizializza una nuova istanza della classe MailMessage utilizzando gli oggetti della classe String specificata.
MailMessage(String, String, String, String)	Inizializza una nuova istanza della classe MailMessage.

MailMessage()

Origine:

MailMessage.cs

Inizializza un'istanza vuota della classe MailMessage.

public:
 MailMessage();

public MailMessage ();

Public Sub New ()

Commenti

Da è impostato sul valore nell'elemento di rete perl'elemento smtp> mailSettings<(Impostazioni di rete) se presente.

MailMessage(MailAddress, MailAddress)

Origine:

MailMessage.cs

Inizializza una nuova istanza della classe MailMessage utilizzando gli oggetti della classe MailAddress specificata.

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)

Parametri

from

MailAddress

Classe MailAddress contenente l'indirizzo del mittente del messaggio di posta elettronica.

to

MailAddress

Classe MailAddress contenente l'indirizzo del destinatario del messaggio di posta elettronica.

Eccezioni

ArgumentNullException

from è null.

-oppure-

to è null.

FormatException

from o to non è corretto.

Esempio

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

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

Commenti

La From proprietà viene inizializzata usando from e la To proprietà viene inizializzata usando to.

MailMessage(String, String)

Origine:

MailMessage.cs

Inizializza una nuova istanza della classe MailMessage utilizzando gli oggetti della classe String specificata.

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)

Parametri

from

String

Classe String contenente l'indirizzo del mittente del messaggio di posta elettronica.

to

String

Classe String contenente gli indirizzi dei destinatari del messaggio di posta elettronica. Più indirizzi di posta elettronica devono essere separati da una virgola (",").

Eccezioni

ArgumentNullException

from è null.

-oppure-

to è null.

ArgumentException

from è Empty ("").

-oppure-

to è Empty ("").

FormatException

from o to non è corretto.

Esempio

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

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

Commenti

La From proprietà viene inizializzata usando from e la To proprietà viene inizializzata usando to.

MailMessage(String, String, String, String)

Origine:

MailMessage.cs

Inizializza una nuova istanza della classe 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)

Parametri

from

String

Classe String contenente l'indirizzo del mittente del messaggio di posta elettronica.

to

String

Classe String contenente gli indirizzi dei destinatari del messaggio di posta elettronica. Più indirizzi di posta elettronica devono essere separati da una virgola (",").

subject

String

Classe String che contiene il testo dell'oggetto.

body

String

Classe String contenente il corpo del messaggio.

Eccezioni

ArgumentNullException

from è null.

-oppure-

to è null.

ArgumentException

from è Empty ("").

-oppure-

to è Empty ("").

FormatException

from o to non è corretto.

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

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

Commenti

Le proprietà per il nuovo MailMessage oggetto vengono inizializzate come segue:

Parametro	Proprietà
from	From
to	To
subject	Subject
body	Body

Per impostazione predefinita, si presuppone che l'oggetto e il contenuto usino la codifica predefinita in base alle impostazioni del computer locale. Usare le BodyEncoding proprietà e SubjectEncoding per specificare codifica diverse.