Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

MailMessage.Headers-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft den e-Mail-Headern, die übertragen werden mit dieser e-Mail-Nachricht ab.

Namespace:   System.Net.Mail
Assembly:  System (in System.dll)

public NameValueCollection Headers { get; }

Eigenschaftswert

Type: System.Collections.Specialized.NameValueCollection

Ein NameValueCollection der die e-Mail-Header enthält.

Die Headers -Eigenschaft ermöglicht einer Anwendung Zugriff auf die headerauflistung der Nachricht. Während diese Auflistung schreibgeschützt ist (eine neue Auflistung kann nicht festgelegt werden), benutzerdefinierte Header hinzugefügt werden können oder aus dieser Auflistung gelöscht. Alle benutzerdefinierten hinzugefügten Header werden eingeschlossen, wenn der MailMessage -Instanz gesendet wird. Vor dem Senden einer Nachricht hinzugefügt nur Header, die speziell für diese Sammlung in der Headers Eigenschaft in der Auflistung enthalten sind. Nach der MailMessage Instanz gesendet wird, die Headers Eigenschaft gehören auch Header, die mit den zugeordneten Eigenschaften der festgelegt werden die MailMessage Klasse oder Parameter übergeben wird, wenn ein MailMessage Dient zum Initialisieren einer MailMessage Objekt.

Wenn einige e-Mail-Kopfzeilen fehlerhaft sind, können sie bewirken, dass die e-Mail-Nachricht beschädigt werden. Also alle e-Mail-Header in der headerauflistung, die über eine Eigenschaft festgelegt werden kann die MailMessage Klasse sollte nur festgelegt werden, mit der MailMessage Klasseneigenschaft oder als Parameter übergeben wird, wenn eine MailMessage Initialisiert ein MailMessage Objekt. Die folgende Liste von e-Mail-Kopfzeilen sollte nicht mit hinzugefügt werden die Headers -Eigenschaft und keine Werte festgelegt werden, für diese Header mit der Headers Eigenschaft werden verworfen oder überschrieben, wenn die Nachricht gesendet wird:

  • Bcc

  • Cc

  • Content-ID

  • Content-Location

  • Content-Transfer-Encoding

  • Content-Type

  • Datum

  • from

  • Bedeutung

  • MIME-Version

  • Priorität

  • Anworten an

  • Sender

  • Aufgabe

  • X-Priorität

Wenn ein Header X-Sender mit die Anwendung nicht angegeben ist die Headers -Eigenschaft, die MailMessage Klasse erstellt, wenn die Nachricht gesendet wird.

Absender, Empfänger, Betreff und Text der e-Mail-Nachricht können als Parameter angegeben werden bei einer MailMessage Dient zum Initialisieren einer MailMessage Objekt. Diese Parameter können auch festgelegt werden, oder Zugriff auf die Verwendung von Eigenschaften für die MailMessage Objekt.

Die primären e-Mail-Header und-Elemente für die Meldung, können mithilfe der folgenden Eigenschaften festgelegt werden die MailMessage Klasse.

E-Mail-Kopfzeile oder Teil

Property

Anlagen

Attachments

Blindkopien (BCC)

Bcc

Eine Kopie (CC)

CC

Content-Type

BodyEncoding

Codieren für benutzerdefinierte Header

HeadersEncoding

Nachrichtentext

Body

Priorität

Priority

Empfänger

To

Anworten an

ReplyToList

Sender

From

Betreff

Subject

Im folgenden Codebeispiel wird veranschaulicht, wie die Header für eine e-Mail-Nachricht.

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 e-mail 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 e-mail 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();
}

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: