MailMessage Klas

Definitie

public ref class MailMessage : IDisposable

public class MailMessage : IDisposable

type MailMessage = class
    interface IDisposable

Public Class MailMessage
Implements IDisposable

Overname

Object

MailMessage

Implementeringen

IDisposable

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een e-mailbericht maakt en verzendt dat een bijlage bevat.

public static void CreateMessageWithAttachment(string server)
{
    // Specify the file to be attached and sent.
    // This example assumes that a file named Data.xls exists in the
    // current working directory.
    string file = "data.xls";
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
        "jane@contoso.com",
        "ben@contoso.com",
        "Quarterly data report.",
        "See the attached spreadsheet.");

    // Create  the file attachment for this email message.
    Attachment data = new Attachment(file, MediaTypeNames.Application.Octet);
    // Add time stamp information for the file.
    ContentDisposition disposition = data.ContentDisposition;
    disposition.CreationDate = System.IO.File.GetCreationTime(file);
    disposition.ModificationDate = System.IO.File.GetLastWriteTime(file);
    disposition.ReadDate = System.IO.File.GetLastAccessTime(file);
    // Add the file attachment to this email message.
    message.Attachments.Add(data);

    //Send the message.
    SmtpClient client = new SmtpClient(server);
    // Add credentials if the SMTP server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateMessageWithAttachment(): {0}",
            ex.ToString());
    }
    // Display the values in the ContentDisposition for the attachment.
    ContentDisposition cd = data.ContentDisposition;
    Console.WriteLine("Content disposition");
    Console.WriteLine(cd.ToString());
    Console.WriteLine("File {0}", cd.FileName);
    Console.WriteLine("Size {0}", cd.Size);
    Console.WriteLine("Creation {0}", cd.CreationDate);
    Console.WriteLine("Modification {0}", cd.ModificationDate);
    Console.WriteLine("Read {0}", cd.ReadDate);
    Console.WriteLine("Inline {0}", cd.Inline);
    Console.WriteLine("Parameters: {0}", cd.Parameters.Count);
    foreach (DictionaryEntry d in cd.Parameters)
    {
        Console.WriteLine("{0} = {1}", d.Key, d.Value);
    }
    data.Dispose();
}

Public Shared Sub CreateMessageWithAttachment(ByVal server As String)
    ' Specify the file to be attached And sent.
    ' This example assumes that a file named Data.xls exists in the
    ' current working directory.
    Dim file As String = "data.xls"
    ' Create a message and set up the recipients.
    Dim message As MailMessage = New MailMessage(
        "jane@contoso.com",
        "ben@contoso.com",
        "Quarterly data report.",
        "See the attached spreadsheet.")

    ' Create  the file attachment for this email message.
    Dim data As Attachment = New Attachment(file, MediaTypeNames.Application.Octet)
    ' Add time stamp information for the file.
    Dim disposition As ContentDisposition = data.ContentDisposition
    disposition.CreationDate = System.IO.File.GetCreationTime(file)
    disposition.ModificationDate = System.IO.File.GetLastWriteTime(file)
    disposition.ReadDate = System.IO.File.GetLastAccessTime(file)
    ' Add the file attachment to this email message.
    message.Attachments.Add(data)

    ' Send the message
    Dim client As SmtpClient = New SmtpClient(server)
    ' Add credentials if the SMTP server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials

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

    ' Display the values in the ContentDisposition for the attachment.
    Dim cd As ContentDisposition = data.ContentDisposition
    Console.WriteLine("Content disposition")
    Console.WriteLine(cd.ToString())
    Console.WriteLine("File {0}", cd.FileName)
    Console.WriteLine("Size {0}", cd.Size)
    Console.WriteLine("Creation {0}", cd.CreationDate)
    Console.WriteLine("Modification {0}", cd.ModificationDate)
    Console.WriteLine("Read {0}", cd.ReadDate)
    Console.WriteLine("Inline {0}", cd.Inline)
    Console.WriteLine("Parameters: {0}", cd.Parameters.Count)

    For Each d As DictionaryEntry In cd.Parameters
        Console.WriteLine("{0} = {1}", d.Key, d.Value)
    Next

    data.Dispose()
End Sub

Opmerkingen

Exemplaren van de MailMessage klasse worden gebruikt om e-mailberichten te maken die worden verzonden naar een SMTP-server voor levering met behulp van de SmtpClient klasse.

De afzender, ontvanger, onderwerp en hoofdtekst van een e-mailbericht kunnen worden opgegeven als parameters wanneer een MailMessage object wordt geïnitialiseerd MailMessage . Deze parameters kunnen ook worden ingesteld of geopend met behulp van eigenschappen voor het MailMessage object.

De primaire berichtkoppen en -elementen voor het bericht kunnen worden ingesteld met behulp van de volgende eigenschappen van de MailMessage klasse.

Met MailMessage de klasse kan een toepassing ook toegang krijgen tot de verzameling headers voor het bericht met behulp van de Headers eigenschap. Hoewel deze verzameling het kenmerk Alleen-lezen heeft (een nieuwe verzameling kan niet worden ingesteld), kunnen aangepaste headers worden toegevoegd aan of verwijderd uit deze verzameling. Aangepaste headers die worden toegevoegd, worden opgenomen wanneer het MailMessage exemplaar wordt verzonden. Voordat een bericht wordt verzonden, worden alleen headers die specifiek zijn toegevoegd aan deze verzameling in de Headers eigenschap opgenomen in de verzameling. Nadat een MailMessage exemplaar is verzonden, bevat de Headers eigenschap ook headers die zijn ingesteld met behulp van de bijbehorende eigenschappen van de MailMessage klasse of parameters die worden doorgegeven wanneer een MailMessage object wordt geïnitialiseerd MailMessage .

Als sommige e-mailkoppen ongeldig zijn, kunnen ze ertoe leiden dat het e-mailbericht beschadigd raakt. Alle e-mailheaders in de verzameling kopteksten die kunnen worden ingesteld met behulp van een eigenschap in de MailMessage klasse, moeten dus alleen worden ingesteld met behulp van de MailMessage klasse-eigenschap of als parameter die wordt doorgegeven wanneer een MailMessageMailMessage object wordt geïnitialiseerd. De volgende lijst met e-mailkoppen mag niet worden toegevoegd met behulp van de Headers eigenschap en alle waarden die zijn ingesteld voor deze kopteksten met behulp van de Headers eigenschap, worden verwijderd of overschreven wanneer het bericht wordt verzonden:

• Bcc
• CC
• Inhouds-id
• Inhoudslocatie
• Inhoud-Transfer-Encoding
• Inhoudstype
• Date
• Van
• Urgentie
• MIME-Version
• Priority
• Reply-To
• Afzender
• Tot
• X-prioriteit

Als de toepassing geen X-Sender-header opgeeft met behulp van de Headers eigenschap, wordt er MailMessage een gemaakt wanneer het bericht wordt verzonden.

Gebruik de AlternateViews eigenschap om kopieën van een e-mailbericht in verschillende indelingen op te geven. Als u bijvoorbeeld een bericht in HTML verzendt, kunt u ook een tekst zonder opmaak opgeven voor het geval sommige geadresseerden e-maillezers gebruiken die HTML-inhoud niet kunnen weergeven. Zie voor een voorbeeld van het maken van een bericht met alternatieve weergaven AlternateViews.

Gebruik de Attachments eigenschap om bijlagen toe te voegen aan een e-mailbericht. Zie voor een voorbeeld van het maken van een bericht met een bijlage Attachments. Als u Het aanroepen van Verwijderen op de MailMessage aanroept, wordt ook elke bijlage waarnaar wordt verwezen, verwijderd.

Nadat u uw e-mailbericht hebt samengesteld, kunt u het verzenden met behulp van de Send of SendAsync methoden.