MailAddress Konstruktoren

Referenz

Definition

Namespace:: System.Net.Mail

Assembly:: System.Net.Mail.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der MailAddress-Klasse.

Überlädt

MailAddress(String)	Initialisiert eine neue Instanz der MailAddress-Klasse mithilfe der angegebenen Adresse.
MailAddress(String, String)	Initialisiert eine neue Instanz der MailAddress-Klasse unter Verwendung der angegebenen Bindung und Endpunktadresse.
MailAddress(String, String, Encoding)	Initialisiert eine neue Instanz der MailAddress-Klasse unter Verwendung der angegebenen Adresse, des angegebenen Anzeigenamens und der angegebenen Codierung.

MailAddress(String)

Quelle:: MailAddress.cs

Quelle:: MailAddress.cs

Quelle:: MailAddress.cs

Initialisiert eine neue Instanz der MailAddress-Klasse mithilfe der 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

Ein String mit einer E-Mail-Adresse.

Ausnahmen

ArgumentNullException

address ist null.

ArgumentException

address ist Empty („“).

FormatException

Das Format von address wurde nicht erkannt.

Beispiele

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

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

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 zugeordnete E-Mail-Adresse enthalten, wenn Sie die Adresse in spitzen Klammern einschließen. Beispiel:

"Tom Smith <tsmith@contoso.com>"

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

Die folgende Tabelle zeigt die Eigenschaftswerte für ein MailAddress Objekt, das mit der obigen Beispieladresse erstellt wurde.

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

Gilt für:

MailAddress(String, String)

Quelle:: MailAddress.cs

Quelle:: MailAddress.cs

Quelle:: MailAddress.cs

Initialisiert eine neue Instanz der MailAddress-Klasse unter Verwendung der angegebenen Bindung und Endpunktadresse.

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

public MailAddress (string address, 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

Ein String mit einer E-Mail-Adresse.

displayName: String

String mit dem Anzeigenamen, der der address zugeordnet ist. Dieser Parameter kann null sein.

Ausnahmen

ArgumentNullException

address ist null.

ArgumentException

address ist Empty („“).

FormatException

Das Format von address wurde nicht erkannt.

- oder -

address enthält Zeichen, die kein ASCII-Format aufweisen.

Beispiele

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

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

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.

Wenn displayName Nicht-ASCII-Zeichen enthalten sind, wird für die Codierung der Zeichensatz iso-8859-1 verwendet displayName . Das Codieren von Nicht-ASCII-Zeichen wird in RFC 1522 erläutert, das unter https://www.ietf.org/verfügbar ist.

Wenn address einen Anzeigenamen enthält und displayName nicht null gleich String.EmptydisplayName ist, überschreibt den in addressangegebenen Wert.

Gilt für:

MailAddress(String, String, Encoding)

Quelle:: MailAddress.cs

Quelle:: MailAddress.cs

Quelle:: MailAddress.cs

Initialisiert eine neue Instanz der MailAddress-Klasse unter Verwendung der angegebenen Adresse, des angegebenen Anzeigenamens und der angegebenen Codierung.

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

public MailAddress (string address, 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

Ein String mit einer E-Mail-Adresse.

displayName: String

Ein String, der den address zugeordneten Anzeigenamen enthält.

displayNameEncoding: Encoding

Die Encoding, die den für displayName verwendeten Zeichensatz definiert.

Ausnahmen

ArgumentNullException

address ist null.

- oder -

displayName ist null.

ArgumentException

address ist Empty („“).

- oder -

displayName ist Empty („“).

FormatException

Das Format von address wurde nicht erkannt.

- oder -

address enthält Zeichen, die kein ASCII-Format aufweisen.

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 = gcnew MailAddress("jane@contoso.com",
    "Jane " + (wchar_t)0xD8 + " Clayton",
    System::Text::Encoding::UTF8);

// 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 einen Anzeigenamen enthält und displayName nicht null gleich String.EmptydisplayName ist, überschreibt den in addressangegebenen Wert.

Die MailAddress -Methode überprüft nicht, ob der displayName Parameter gültig ist. Diese Methode entfernt umgebende Anführungszeichen, die von der DisplayName -Eigenschaft nicht angezeigt werden. Anführungszeichen werden vor der Übertragung hinzugefügt, außer wenn ASCII oder Unicode im displayNameEncoding Parameter angegeben ist. Die im Parameter angegebene Codierung wird vor der displayNameEncoding Übertragung auf die DisplayName -Eigenschaft angewendet oder Unicode im displayNameEncoding -Parameter ASCII angegeben. UTF8 ist die Standardcodierung, wenn keine angegeben ist.

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

Gilt für:

Freigeben über

MailAddress Konstruktoren

Definition

Überlädt

MailAddress(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

MailAddress(String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

MailAddress(String, String, Encoding)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen