Freigeben über


MailAddress Konstruktoren

Definition

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

address ist null.

address ist Empty („“).

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

address ist null.

address ist Empty („“).

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

address ist null.

- oder -

displayName ist null.

address ist Empty („“).

- oder -

displayName ist Empty („“).

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: