MailAddress Konstruktoren

Definition

Namespace:

System.Net.Mail

Assemblys:

netstandard.dll, System.Net.Mail.dll

Initialisiert eine neue Instanz der MailAddress Klasse.

Überlädt

Name	Beschreibung
MailAddress(String)	Initialisiert eine neue Instanz der Klasse mithilfe der MailAddress angegebenen Adresse.
MailAddress(String, String)	Initialisiert eine neue Instanz der Klasse mithilfe der MailAddress angegebenen Adresse und des Anzeigenamens.
MailAddress(String, String, Encoding)	Initialisiert eine neue Instanz der Klasse mithilfe der MailAddress angegebenen Adresse, des Anzeigenamens und der Codierung.

MailAddress(String)

Quelle:

MailAddress.cs

Initialisiert eine neue Instanz der Klasse mithilfe der MailAddress angegebenen Adresse.

public:
 MailAddress(System::String ^ address);

public MailAddress(string address);

new System.Net.Mail.MailAddress : string -> System.Net.Mail.MailAddress

Public Sub New (address As String)

Parameter

address

String

A String that contains an email address.

Ausnahmen

ArgumentNullException

address ist null.

ArgumentException

address ist Empty ("").

FormatException

address ist nicht in einem erkannten Format vorhanden.

Beispiele

Im folgenden Codebeispiel wird dieser Konstruktor verwendet, um ein MailAddress Objekt für den Bcc Empfänger einer E-Mail-Nachricht zu erstellen.

public static void CreateBccTestMessage(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.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateBccTestMessage(): {0}",
            ex.ToString());
    }
}

Hinweise

Der address Parameter kann einen Anzeigenamen und die zugehörige E-Mail-Adresse enthalten, wenn Sie die Adresse in winkelige Klammern einschließen. Beispiel:

"Tom Smith <tsmith@contoso.com>"

Leerzeichen sind zwischen dem Anzeigenamen und den winkeln Klammern zulässig.

In der folgenden Tabelle sind die Eigenschaftswerte für ein MailAddress Objekt dargestellt, das mit der vorherigen Beispieladresse erstellt wurde.

Eigentum	Wert
DisplayName	"Tom Smith"
Host	"contoso.com"
User	"tsmith"
Address	"tsmith@contoso.com"

MailAddress(String, String)

Quelle:

MailAddress.cs

Initialisiert eine neue Instanz der Klasse mithilfe der MailAddress angegebenen Adresse und des Anzeigenamens.

public:
 MailAddress(System::String ^ address, System::String ^ displayName);

public MailAddress(string address, string? displayName);

new System.Net.Mail.MailAddress : string * string -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String)

Parameter

address

String

A String that contains an email address.

displayName

String

A String , das den anzeigenamen enthält, der zugeordnet addressist. Dieser Parameter kann null sein.

Ausnahmen

ArgumentNullException

address ist null.

ArgumentException

address ist Empty ("").

FormatException

address ist nicht in einem erkannten Format vorhanden.

-oder-

address enthält Nicht-ASCII-Zeichen.

Beispiele

Im folgenden Codebeispiel wird dieser Konstruktor verwendet, um Instanzen für den Absender und den Empfänger einer E-Mail-Nachricht zu erstellen MailAddress .

public static void CreateBccTestMessage(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.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateBccTestMessage(): {0}",
            ex.ToString());
    }
}

Hinweise

Führende und nachfolgende Leerzeichen im Anzeigenamen bleiben erhalten.

Enthält displayName Nicht-ASCII-Zeichen, wird der Iso-8859-1-Zeichensatz für die displayName Codierung verwendet. Das Codieren von Nicht-ASCII-Zeichen wird in RFC 1522 erläutert, das unter https://www.ietf.org/.

Wenn address ein Anzeigename enthalten ist und displayName nicht null gleich String.Emptyist, displayName überschreibt der in address.

Der MailAddress(String, String) Konstruktor überprüft nicht, ob der displayName Parameter gültig ist. Diese Methode entfernt umgebende Anführungszeichen, die nicht von der DisplayName Eigenschaft angezeigt werden. Angebote werden vor der Übertragung hinzugefügt. UTF8 Die Codierung wird vor der Übertragung auf die DisplayName Eigenschaft angewendet.

MailAddress(String, String, Encoding)

Quelle:

MailAddress.cs

Initialisiert eine neue Instanz der Klasse mithilfe der MailAddress angegebenen Adresse, des Anzeigenamens und der Codierung.

public:
 MailAddress(System::String ^ address, System::String ^ displayName, System::Text::Encoding ^ displayNameEncoding);

public MailAddress(string address, string? displayName, System.Text.Encoding? displayNameEncoding);

new System.Net.Mail.MailAddress : string * string * System.Text.Encoding -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String, displayNameEncoding As Encoding)

Parameter

address

String

A String that contains an email address.

displayName

String

A String , das den anzeigenamen enthält, der zugeordnet addressist.

displayNameEncoding

Encoding

Dies Encoding definiert den zeichensatz, der für displayName.

Ausnahmen

ArgumentNullException

address ist null.

-oder-

displayName ist null.

ArgumentException

address ist Empty ("").

-oder-

displayName ist Empty ("").

FormatException

address ist nicht in einem erkannten Format vorhanden.

-oder-

address enthält Nicht-ASCII-Zeichen.

Beispiele

Im folgenden Codebeispiel wird dieser Konstruktor verwendet, um Instanzen für den Absender einer E-Mail-Nachricht zu erstellen MailAddress .

// Create a mailing address that includes a UTF8 character
// in the display name.
MailAddress from = new MailAddress("jane@contoso.com",
   "Jane " + (char)0xD8+ " Clayton",
System.Text.Encoding.UTF8);

' Create a mailing address that includes a UTF8 character
' in the display name.
Dim mailFrom As New MailAddress("jane@contoso.com", "Jane " & ChrW(&HD8) & " Clayton", System.Text.Encoding.UTF8)

Hinweise

Führende und nachfolgende Leerzeichen im Anzeigenamen bleiben erhalten.

Wenn address ein Anzeigename enthalten ist und displayName nicht null gleich String.Emptyist, displayName überschreibt der in address.

Der MailAddress(String, String, Encoding) Konstruktor überprüft nicht, ob der displayName Parameter gültig ist. Diese Methode entfernt umgebende Anführungszeichen, die nicht von der DisplayName Eigenschaft angezeigt werden. Anführungszeichen werden vor der Übertragung hinzugefügt, es sei denn, es ASCII wird im displayNameEncoding Parameter angegeben oder Unicode angegeben. Die im displayNameEncoding Parameter angegebene Codierung wird vor der Übertragung ASCII auf die DisplayName Eigenschaft angewendet oder Unicode im displayNameEncoding Parameter angegeben. UTF8 ist die Standardcodierung, wenn keine angegeben wird.

Weitere Informationen zu unterstützten E-Mail-Adressformaten finden Sie unter MailAddress.