MailMessage.Headers Свойство

Определение

Пространство имен:

System.Net.Mail

Сборки:

netstandard.dll, System.Net.Mail.dll

Исходный код:

MailMessage.cs

Возвращает заголовки электронной почты, передаваемые с помощью этого сообщения электронной почты.

public:
 property System::Collections::Specialized::NameValueCollection ^ Headers { System::Collections::Specialized::NameValueCollection ^ get(); };

public System.Collections.Specialized.NameValueCollection Headers { get; }

member this.Headers : System.Collections.Specialized.NameValueCollection

Public ReadOnly Property Headers As NameValueCollection

Значение свойства

NameValueCollection

Объект, NameValueCollection содержащий заголовки электронной почты.

Примеры

В следующем примере кода показано отображение заголовков для почтового сообщения.

public static void CreateMessageWithAttachment4(string server, string to)
{
    // Specify the file to be attached and sent.
    // This example uses a file on a UNC share.
    string file = @"\\share3\c$\reports\data.xls";
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
       "ReportMailer@contoso.com",
       to,
       "Quarterly data report",
       "See the attached spreadsheet.");

    // Create  the file attachment for this email message.
    Attachment data = new Attachment("qtr3.xls", 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);
    disposition.DispositionType = DispositionTypeNames.Attachment;
    // 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 = (ICredentialsByHost)CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    // Display the message headers.
    string[] keys = message.Headers.AllKeys;
    Console.WriteLine("Headers");
    foreach (string s in keys)
    {
        Console.WriteLine("{0}:", s);
        Console.WriteLine("    {0}", message.Headers[s]);
    }
    data.Dispose();
}

Public Shared Sub CreateMessageWithAttachment4(ByVal server As String, ByVal [to] As String)
    ' Specify the file to be attached And sent.
    ' This example uses a file on a UNC share.
    Dim file As String = "\\share3\c$\reports\data.xls"
    Dim message As MailMessage = New MailMessage("ReportMailer@contoso.com", [to], "Quarterly data report", "See the attached spreadsheet.")
    ' Create  the file attachment for this email message.
    Dim data As Attachment = New Attachment("qtr3.xls", 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)
    disposition.DispositionType = DispositionTypeNames.Attachment
    ' 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 = CType(CredentialCache.DefaultNetworkCredentials, ICredentialsByHost)
    client.Send(message)
    ' Display the message headers.
    Dim keys As String() = message.Headers.AllKeys
    Console.WriteLine("Headers")

    For Each s As String In keys
        Console.WriteLine("{0}:", s)
        Console.WriteLine("    {0}", message.Headers(s))
    Next

    data.Dispose()
End Sub

Комментарии

Свойство Headers позволяет приложению получить доступ к коллекции заголовков для сообщения. Хотя эта коллекция доступна только для чтения (новая коллекция не может быть задана), пользовательские заголовки можно добавлять или удалять из этой коллекции. Все добавленные пользовательские заголовки будут включены при отправке экземпляра MailMessage . Перед отправкой сообщения в коллекцию включаются только заголовки, добавленные в Headers эту коллекцию. После отправки экземпляра MailMessage свойство также будет включать заголовки, заданные с помощью связанных свойств MailMessage класса или параметров, передаваемых при MailMessage инициализации MailMessageHeaders объекта.

Если некоторые заголовки почты повреждены, они могут привести к повреждению сообщения электронной почты. Поэтому любой заголовок почты в коллекции заголовков, который можно задать с помощью свойства класса, MailMessage должен быть задан только с помощью MailMessage свойства класса или в качестве параметра, передаваемого MailMessage при MailMessage инициализации объекта. Следующий список заголовков почты не должен быть добавлен с помощью Headers свойства и любые значения, заданные для этих заголовков с помощью Headers свойства, будут удалены или перезаписаны при отправке сообщения:

• Bcc

• Копия (Cc)

• Идентификатор содержимого

• Расположение содержимого

• Кодировка передачи содержимого

• Тип содержимого

• Дата

• От

• Важность

• MIME-Version

• Priority

• Reply-To

• Отправитель

• Кому

• Приоритет X

Если приложение не указывает заголовок X-Sender с помощью Headers свойства, MailMessage класс создаст его при отправке сообщения.

Отправитель, получатель, тема и текст сообщения электронной почты могут быть указаны в качестве параметров, когда MailMessage используется для инициализации MailMessage объекта. Эти параметры также могут быть заданы или доступны с помощью свойств объекта MailMessage .

Заголовки и элементы основного почтового MailMessage сообщения для сообщения могут быть заданы с помощью следующих свойств класса.

Заголовок или часть почты	Недвижимость
Attachments	Attachments
Слепые углеродные копии (BCC)	Bcc
Углеродные копии (CC)	CC
Тип содержимого	BodyEncoding
Кодировка для пользовательских заголовков	HeadersEncoding
Текст сообщения	Body
Priority	Priority
Recipient	To
Reply-To	ReplyToList
Отправитель	From
Тема	Subject