(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

MailMessage.Headers-Eigenschaft

Ruft die E-Mail-Header ab, die mit dieser E-Mail-Nachricht übertragen werden.

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

public NameValueCollection Headers { get; }

Eigenschaftswert

Typ: System.Collections.Specialized.NameValueCollection
Eine NameValueCollection mit den E-Mail-Headern.

Die Headers-Eigenschaft ermöglicht es einer Anwendung, auf die Headerauflistung für die Meldung zuzugreifen. Während diese Auflistung schreibgeschützt ist (eine neue Auflistung kann nicht festgelegt werden), können benutzerdefinierte Header dieser Auflistung hinzugefügt werden oder daraus gelöscht werden. Alle benutzerdefinierten hinzugefügten Header werden eingeschlossen, wenn die MailMessage-Instanz gesendet wird. Bevor eine Meldung gesendet wird, sind nur Header, die ausdrücklich dieser Auflistung in der Headers-Eigenschaft hinzugefügt wurden, in der Auflistung enthalten. Nach dem Senden der MailMessage-Instanz enthält die Headers-Eigenschaft auch Header, die mit den zugeordneten Eigenschaften der MailMessage-Klasse festgelegt werden, oder Parameter, die übergeben werden, wenn ein MailMessage verwendet wird, um ein MailMessage-Objekt zu initialisieren.

Wenn einige E-Mail-Kopfzeilen fehlerhaft sind, kann dies dazu führen, dass die E-Mail beschädigt wird. Daher sollte jeder E-Mail-Header in der Headerauflistung, die mit einer Eigenschaft für die MailMessage-Klasse festgelegt werden kann, nur mit der MailMessage-Klasseneigenschaft oder als Parameter festgelegt werden, der übergeben wird, wenn ein MailMessage ein MailMessage-Objekt initialisiert. Die folgende Liste von E-Mail-Kopfzeilen sollte nicht mit der Headers-Eigenschaft hinzugefügt werden, und alle Werte, die für diese Header mit der Headers-Eigenschaft festgelegt wurden, werden verworfen oder überschrieben, wenn die Meldung gesendet wird:

  • Bcc

  • Cc

  • Content-ID

  • Content-Location

  • Content-Transfer-Encoding

  • Content-Type

  • Datum

  • from

  • Wichtigkeit

  • MIME-Version

  • Priorität

  • Anworten an

  • Absender

  • Zum

  • X-Priorität

Wenn die Anwendung keine X-Sender-Kopfzeile mit der Headers-Eigenschaft angibt, erstellt die MailMessage-Klasse die Kopfzeile beim Senden der Nachricht.

Der Absender, Empfänger, Betreff und Text einer E-Mail können als Parameter angegeben werden, wenn ein MailMessage verwendet wird, um ein MailMessage-Objekt zu initialisieren. Diese Parameter können auch mit Eigenschaften für das MailMessage-Objekt festgelegt oder verwendet werden.

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

E-Mail-Header oder -Teil

Eigenschaft

Attachments

Attachments

Bcc

Bcc

Cc

CC

Content-Type

BodyEncoding

Codieren für benutzerdefinierte Header

HeadersEncoding

Nachrichtentext

Body

Priorität

Priority

Empfänger

To

Anworten an

ReplyToList

Absender

From

Betreff

Subject

Im folgenden Codebeispiel wird das Anzeigen der Header für eine E-Mail-Nachricht veranschaulicht.


		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

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft