MailAddress-Klasse

Die MailAddress-Klasse wird von der SmtpClient-Klasse und der MailMessage-Klasse zum Speichern von Adressinformationen für E-Mail-Nachrichten verwendet.

Eine E-Mail-Adresse besteht aus einem User-Namen, einem Host-Name und einem optionalen DisplayName. Der DisplayName kann Zeichen enthalten, die nicht das ASCII-Format aufweisen, wenn Sie sie codieren.

Die MailAddress-Klasse unterstützt diese folgenden E-Mail-Adressformate:

• Ein einfaches Adressformat von user@host. Wenn kein DisplayName festgelegt ist, wird dieses E-Mail-Adressformat generiert.

• Ein standardmäßiges mit Anführungszeichen versehenes Anzeigenamenformat von "display name" <user@host>. Wenn ein DisplayName festgelegt ist, wird dieses Format generiert.

• Spitze Klammern werden um den User-Namen, Host-Namen für "display name" user@host hinzugefügt, wenn diese nicht eingeschlossen sind.

• Anführungszeichen werden um den DisplayName für display name <user@host> hinzugefügt, wenn diese nicht enthalten sind.

• Unicode-Zeichen werden im DisplayName unterstützt. -Eigenschaft.

• Ein User-Name mit Anführungszeichen. Beispielsweise "user name"@host.

• Aufeinander folgende und nachfolgende Punkte in Benutzernamen. Beispielsweise user...name..@host.

• Domänenliterale in Klammern. Beispielsweise <user@[my domain]>.

• Comments. Beispielsweise (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Kommentare werden vor der Übertragung entfernt.

Ein Komma wird verwendet, um Elemente in einer Liste von E-Mail-Adressen zu trennen. Als Folge sollte ein Komma nicht in Anzeigenamen ohne Anführungszeichen in einer Liste verwendet werden. Die folgenden E-Mail-Adressen würden nicht zugelassen werden

"John, Doe" <user@host>, "Bob, Smith" <user2@host>

Die folgende E-Mail-Adresse würde nicht zugelassen werden:

John, Doe <user@host>, Bob, Smith <user2@host>

Anführungszeichen können in eine Zeichenfolge in Anführungszeichen eingebettet werden, aber sie müssen mit Escapezeichen versehen werden. Die folgenden E-Mail-Adressen würden nicht zugelassen werden

"John \"Jr\" Doe" <user@host>

"\"John \\\"Jr\\\" Doe\" <user@host>"

Die folgende E-Mail-Adresse würde nicht zugelassen werden:

"John "Jr" Doe" <user@host>

Wenn der Benutzername nicht in Anführungszeichen steht, wird aller Text zwischen dem Start der Zeichenfolge (oder Komma) und der Adresse, die als Teil vom DisplayName betrachtet, einschließlich der Kommentare.

-- Beispiel: (ohne Kommentar) nicht in Anführungszeichen eingeschlossener (ohne Kommentar) Anzeigename (ohne Kommentar) <Benutzer@Host>

Obwohl die MailAddress-Klasse eine E-Mail-Adresse als gültig akzeptiert, akzeptieren andere E-Mail-Server die E-Mail-Adresse möglicherweise nicht.

Die MailAddress-Klasse unterstützt diese folgenden E-Mail-Adressformate nicht:

Anzeigenamen gleichzeitig mit und ohne Anführungszeichen. Beispiel: display "name" <user@host>.

Gruppen, gemäß der von IETF veröffentlichten Definition in RFC 2822, Abschnitt 3.4.

Die veralteten Benutzernamenformate "user"."name"@host, user."name"@host oder "user".name@host.

Im folgenden Codebeispiel wird das Senden einer E-Mail-Nachricht unter Verwendung der SmtpClient-Klasse, der MailAddress-Klasse und der MailMessage-Klasse veranschaulicht.

		public static void CreateCopyMessage(string server)
		{
			MailAddress from = new MailAddress("ben@contoso.com", "Ben Miller");
			MailAddress to = new MailAddress("jane@contoso.com", "Jane Clayton");
			MailMessage message = new MailMessage(from, to);
			// message.Subject = "Using the SmtpClient class.";
			message.Subject = "Using the SmtpClient class.";
			message.Body = @"Using this feature, you can send an e-mail message from an application very easily.";
			// Add a carbon copy recipient.
			MailAddress copy = new MailAddress("Notification_List@contoso.com");
			message.CC.Add(copy);
			SmtpClient client = new SmtpClient(server);
			// Include credentials if the server requires them.
			client.Credentials = CredentialCache.DefaultNetworkCredentials;
			Console.WriteLine("Sending an e-mail message to {0} by using the SMTP host {1}.",
				 to.Address, client.Host);
	
	    try {
        client.Send(message);
      }
      catch (Exception ex) {
        Console.WriteLine("Exception caught in CreateCopyMessage(): {0}", 
                    ex.ToString() );
  	  }
    }

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz