MailAddress Konstruktory

Reference

Definice

Obor názvů:: System.Net.Mail

Sestavení:: System.Net.Mail.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci MailAddress třídy.

Přetížení

MailAddress(String)	Inicializuje novou instanci MailAddress třídy pomocí zadané adresy.
MailAddress(String, String)	Inicializuje novou instanci MailAddress třídy pomocí zadané adresy a zobrazovaného názvu.
MailAddress(String, String, Encoding)	Inicializuje novou instanci MailAddress třídy pomocí zadané adresy, zobrazovaného názvu a kódování.

MailAddress(String)

Zdroj:: MailAddress.cs

Zdroj:: MailAddress.cs

Zdroj:: MailAddress.cs

Inicializuje novou instanci MailAddress třídy pomocí zadané adresy.

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)

Parametry

address: String

A String obsahující e-mailovou adresu.

Výjimky

ArgumentNullException

address je null.

ArgumentException

address je Empty ("").

FormatException

address není v rozpoznané podobě.

Příklady

Následující příklad kódu používá tento konstruktor k vytvoření MailAddress objektu Bcc pro příjemce e-mailové zprávy.

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

Poznámky

Parametr address může obsahovat zobrazované jméno a přidruženou e-mailovou adresu, pokud adresu uzavřete do šikmých závorek. Příklad:

"Tom Smith <tsmith@contoso.com>"

Mezi zobrazovaným názvem a úhlovými hranatými závorkami je povolené prázdné znaky.

Následující tabulka ukazuje hodnoty vlastností objektu MailAddress vytvořeného pomocí předchozí ukázkové adresy.

Vlastnost	Hodnota
DisplayName	`"Tom Smith"`
Host	`"contoso.com"`
User	`"tsmith"`
Address	`"tsmith@contoso.com"`

Platí pro

MailAddress(String, String)

Zdroj:: MailAddress.cs

Zdroj:: MailAddress.cs

Zdroj:: MailAddress.cs

Inicializuje novou instanci MailAddress třídy pomocí zadané adresy a zobrazovaného názvu.

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)

Parametry

address: String

A String obsahující e-mailovou adresu.

displayName: String

A String , který obsahuje zobrazovaný název přidružený k address. Tento parametr může být null.

Výjimky

ArgumentNullException

address je null.

ArgumentException

address je Empty ("").

FormatException

address není v rozpoznané podobě.

-nebo-

address obsahuje jiné znaky než ASCII.

Příklady

Následující příklad kódu používá tento konstruktor k vytvoření MailAddress instancí pro odesílatele a příjemce e-mailové zprávy.

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

Poznámky

Úvodní a koncové prázdné znaky ve zobrazovaném názvu se zachovají.

Pokud displayName obsahuje jiné znaky než ASCII, použije se pro displayName kódování znaková sada iso-8859-1. Kódování znaků jiných než ASCII je popsáno v dokumentu RFC 1522, který je k dispozici na adrese https://www.ietf.org/.

Pokud address obsahuje zobrazovaný název a displayName není null a není roven String.Empty, displayName přepíše hodnotu zadanou v address.

Platí pro

MailAddress(String, String, Encoding)

Zdroj:: MailAddress.cs

Zdroj:: MailAddress.cs

Zdroj:: MailAddress.cs

Inicializuje novou instanci MailAddress třídy pomocí zadané adresy, zobrazovaného názvu a kódování.

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)

Parametry

address: String

A String obsahující e-mailovou adresu.

displayName: String

A String , který obsahuje zobrazovaný název přidružený k address.

displayNameEncoding: Encoding

Ten Encoding , který definuje znakové sady používané pro displayName.

Výjimky

ArgumentNullException

address je null.

-nebo-

displayName je null.

ArgumentException

address je Empty ("").

-nebo-

displayName je Empty ("").

FormatException

address není v rozpoznané podobě.

-nebo-

address obsahuje jiné znaky než ASCII.

Příklady

Následující příklad kódu používá tento konstruktor k vytvoření MailAddress instancí pro odesílatele e-mailové zprávy.

// 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)

Poznámky

Úvodní a koncové prázdné znaky ve zobrazovaném názvu se zachovají.

Pokud address obsahuje zobrazovaný název a displayName není null a není roven String.Empty, displayName přepíše hodnotu zadanou v address.

Metoda MailAddress nekontroluje, jestli displayName je parametr platný. Tato metoda odebere okolní uvozovky, které nejsou zobrazeny DisplayName vlastností. Před přenosem se přidají uvozovky s výjimkou případů, kdy ASCII parametr Unicode nebo je zadaný displayNameEncoding . Kódování zadané v parametru displayNameEncoding se použije na DisplayName vlastnost před přenosem ASCII nebo Unicode je zadáno v parametru displayNameEncoding . UTF8 je výchozí kódování, pokud není zadáno žádné.

Další informace o podporovaných formátech e-mailových adres najdete v tématu MailAddress.

Platí pro

Sdílet prostřednictvím

MailAddress Konstruktory

Definice

Přetížení

MailAddress(String)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

MailAddress(String, String)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

MailAddress(String, String, Encoding)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

Další materiály