MailAddress MailAddress MailAddress MailAddress Class

Definition

Stellt die Adresse eines E-Mail-Absenders oder -Empfängers dar.Represents the address of an electronic mail sender or recipient.

public ref class MailAddress
public class MailAddress
type MailAddress = class
Public Class MailAddress
Vererbung
MailAddressMailAddressMailAddressMailAddress

Beispiele

Im folgenden Codebeispiel wird das Senden einer e-Mail- SmtpClientNachricht MailAddressmithilfe der MailMessage Klassen, und veranschaulicht.The following code example demonstrates sending an email message by using the SmtpClient, MailAddress, and MailMessage classes.

static void CreateCopyMessage( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com",L"Ben Miller" );
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com",L"Jane Clayton" );
   MailMessage^ message = gcnew MailMessage( from,to );
   
   // message.Subject = "Using the SmtpClient class.";
   message->Subject = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   
   // Add a carbon copy recipient.
   MailAddress^ copy = gcnew MailAddress( L"Notification_List@contoso.com" );
   message->CC->Add( copy );
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Include credentials if the server requires them.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} by using the SMTP host {1}.", to->Address, client->Host );
   client->Send( message );
   client->~SmtpClient();
}


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

Hinweise

Die MailAddress -Klasse wird von den SmtpClient Klassen MailMessage und verwendet, um Adressinformationen für e-Mail-Nachrichten zu speichern.The MailAddress class is used by the SmtpClient and MailMessage classes to store address information for email messages.

Eine e-Mail-Adresse besteht User aus einem Host Namen, einem Namen und DisplayNameoptional einem.A mail address is composed of a User name, Host name and optionally, a DisplayName. DisplayName Kann nicht-ASCII-Zeichen enthalten, wenn Sie Sie codieren.The DisplayName can contain non-ASCII characters if you encode them.

Die MailAddress -Klasse unterstützt die folgenden e-Mail-Adressformate:The MailAddress class supports the following mail address formats:

  • Ein einfaches Adressformat von user@host.A simple address format of user@host. Wenn kein festgelegt ist,istdiesdase-Mail-Adressformat,dasgeneriertwird.DisplayNameIf a DisplayName is not set, this is the mail address format generated.

  • Ein Standardmäßiges Anzeige Namen Format in "display name" <user@host>Anführungszeichen von.A standard quoted display name format of "display name" <user@host>. Wenn ein DisplayName festgelegt ist, ist dies das generierte Format.If a DisplayName is set, this is the format generated.

  • Die Spitze Klammern werden um den User Namen und Host den Namen addiert, wenn diese nicht eingeschlossen werden.Angle brackets are added around the User name and Host name, if these are not included. Beispielsweise "display name" user@host wird in "display name" <user@host>geändert.For example, "display name" user@host is changed to "display name" <user@host>.

  • Wenn diese nicht eingeschlossen sind DisplayName, werden die Anführungszeichen hinzugefügt.Quotes are added around the DisplayName, if these are not included. Beispielsweise display name <user@host> wird in "display name" <user@host>geändert.For example, display name <user@host> is changed to "display name" <user@host>.

  • Unicode-Zeichen werden in der DisplayName -Eigenschaft unterstützt.Unicode characters are supported in the DisplayName property.

  • Ein User Name mit Anführungszeichen.A User name with quotes. Beispielsweise "user name"@host.For example, "user name"@host.

  • Aufeinander folgende und nachfolgende Punkte in den Benutzernamen.Consecutive and trailing dots in user names. Beispielsweise user...name..@host.For example, user...name..@host.

  • Domänen Literale in Klammern.Bracketed domain literals. Beispielsweise <user@[my domain]>.For example, <user@[my domain]>.

  • Iny.Comments. Beispielsweise (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment).For example, (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Kommentare werden vor der Übertragung entfernt.Comments are removed before transmission.

Ein Komma wird zum Trennen von Elementen in einer Liste von e-Mail-Adressen verwendet.A comma is used to separate elements in a list of mail addresses. Folglich sollte ein Komma nicht in anzeigen Amen ohne Anführungszeichen in einer Liste verwendet werden.As a result, a comma should not be used in unquoted display names in a list. Folgende e-Mail-Adressen sind zulässig:The following mail addresses would be allowed:

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

Die folgende e-Mail-Adresse ist nicht zulässig:The following mail address would not be allowed:

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

Anführungszeichen können in Zeichen folgen in Anführungszeichen eingebettet werden, Sie müssen jedoch mit Escapezeichen versehen werden.Quotes can be embedded in a quoted string, but they must be escaped. Folgende e-Mail-Adressen sind zulässig:The following mail addresses would be allowed:

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

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

Die folgende e-Mail-Adresse ist nicht zulässig:The following mail address would not be allowed:

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

Wenn der Benutzername nicht in Anführungszeichen gesetzt wird, werden der gesamte Text zwischen dem Anfang der Zeichenfolge (oder dem Komma) und DisplayNameder Adresse als Teil von, einschließlich der Kommentare, berücksichtigt.When the username is not quoted, all text between the start of the string (or comma) and the address are considered part of the DisplayName, including comments. Beispiel:For example:

(non comment) unquoted display (non comment) name (non comment) <user@host>

Obwohl die MailAddress -Klasse eine e-Mail-Adresse als gültig akzeptiert, akzeptieren andere Mailserver möglicherweise nicht die e-Mail-Adresse.Although the MailAddress class accepts a mail address as valid, other mail servers may not accept the mail address.

Folgende MailAddress e-Mail-Adressformate werden von der-Klasse nicht unterstützt:The MailAddress class does not support the following mail address formats:

  • Anzeigen Amen mit gemischtem und ohne Anführungszeichen.Mixed quoted and unquoted display names. Beispielsweise display "name" <user@host>.For example, display "name" <user@host>.

  • Gruppen, wie in RFC 2822, Abschnitt 3,4, veröffentlicht vom IETF definiert.Groups, as defined in RFC 2822 Section 3.4 published by the IETF.

  • Die veralteten Benutzernamen Formate von "user"."name"@host, user."name"@host oder "user".name@host.The obsolete user name formats of "user"."name"@host, user."name"@host or "user".name@host.

Konstruktoren

MailAddress(String) MailAddress(String) MailAddress(String) MailAddress(String)

Initialisiert eine neue Instanz der MailAddress-Klasse unter Verwendung der angegebenen Adresse.Initializes a new instance of the MailAddress class using the specified address.

MailAddress(String, String) MailAddress(String, String) MailAddress(String, String) MailAddress(String, String)

Initialisiert eine neue Instanz der MailAddress-Klasse unter Verwendung der angegebenen Adresse und des angegebenen Anzeigenamens.Initializes a new instance of the MailAddress class using the specified address and display name.

MailAddress(String, String, Encoding) MailAddress(String, String, Encoding) MailAddress(String, String, Encoding) MailAddress(String, String, Encoding)

Initialisiert eine neue Instanz der MailAddress-Klasse unter Verwendung der angegebenen Adresse, des angegebenen Anzeigenamens und der angegebenen Codierung.Initializes a new instance of the MailAddress class using the specified address, display name, and encoding.

Eigenschaften

Address Address Address Address

Ruft die E-Mail-Adresse ab, die beim Erstellen dieser Instanz angegeben wurde.Gets the email address specified when this instance was created.

DisplayName DisplayName DisplayName DisplayName

Ruft den Anzeigenamen ab, der aus dem Anzeigenamen und den Adressinformationen besteht, die beim Erstellen dieser Instanz angegeben wurden.Gets the display name composed from the display name and address information specified when this instance was created.

Host Host Host Host

Ruft den Hostteil der Adresse ab, der beim Erstellen dieser Instanz angegeben wurde.Gets the host portion of the address specified when this instance was created.

User User User User

Ruft die Benutzerinformationen aus der Adresse ab, die beim Erstellen dieser Instanz angegeben wurde.Gets the user information from the address specified when this instance was created.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Vergleicht zwei E-Mail-Adressen.Compares two mail addresses.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Gibt einen Hashwert für eine E-Mail-Adresse zurück.Returns a hash value for a mail address.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolgenentsprechung dieser Instanz zurück.Returns a string representation of this instance.

Gilt für: