MailAddress Konstruktoren

Quelle:

MailAddress.cs

Quelle:

MailAddress.cs

Quelle:

MailAddress.cs

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

Ausnahmen

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.

Quelle:

MailAddress.cs

Quelle:

MailAddress.cs

Quelle:

MailAddress.cs

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

Ausnahmen

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.

Quelle:

MailAddress.cs

Quelle:

MailAddress.cs

Quelle:

MailAddress.cs

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

Ausnahmen

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.