MailAddress Costruttori

Definizione

Inizializza una nuova istanza della classe MailAddress.

Overload

MailAddress(String)

Inizializza un'istanza nuova della classe MailAddress usando l'indirizzo specificato.

MailAddress(String, String)

Inizializza un'istanza nuova della classe MailAddress usando l'indirizzo e il nome visualizzato specificati.

MailAddress(String, String, Encoding)

Inizializza una nuova istanza della classe MailAddress utilizzando l'indirizzo, il nome visualizzato e la codifica specificati.

MailAddress(String)

Origine:
MailAddress.cs
Origine:
MailAddress.cs
Origine:
MailAddress.cs

Inizializza un'istanza nuova della classe MailAddress usando l'indirizzo specificato.

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)

Parametri

address
String

Oggetto String che contiene un indirizzo di posta elettronica.

Eccezioni

address è null.

address è Empty ("").

address non è in un formato riconosciuto.

Esempio

Nell'esempio di codice seguente viene usato questo costruttore per creare un MailAddress oggetto per il Bcc destinatario di un messaggio di posta elettronica.

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

Commenti

Il address parametro può contenere un nome visualizzato e l'indirizzo di posta elettronica associato se si racchiude l'indirizzo tra parentesi angolari. Ad esempio:

"Tom Smith <tsmith@contoso.com>"

Lo spazio vuoto è consentito tra il nome visualizzato e le parentesi graffe.

Nella tabella seguente vengono illustrati i valori delle proprietà per un MailAddress oggetto costruito usando l'indirizzo di esempio precedente.

Proprietà Valore
DisplayName "Tom Smith"
Host "contoso.com"
User "tsmith"
Address "tsmith@contoso.com"

Si applica a

MailAddress(String, String)

Origine:
MailAddress.cs
Origine:
MailAddress.cs
Origine:
MailAddress.cs

Inizializza un'istanza nuova della classe MailAddress usando l'indirizzo e il nome visualizzato specificati.

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)

Parametri

address
String

Oggetto String che contiene un indirizzo di posta elettronica.

displayName
String

Oggetto String che contiene il nome visualizzato associato a address. Questo parametro può essere null.

Eccezioni

address è null.

address è Empty ("").

address non è in un formato riconosciuto.

-oppure-

address contiene caratteri non ASCII.

Esempio

Nell'esempio di codice seguente viene usato questo costruttore per creare MailAddress istanze per il mittente e il destinatario di un messaggio di posta elettronica.

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

Commenti

Lo spazio vuoto iniziale e finale nel nome visualizzato viene mantenuto.

Se displayName contiene caratteri non ASCII, viene usato il set di caratteri iso-8859-1 per la displayName codifica. La codifica dei caratteri non ASCII viene illustrata in RFC 1522, disponibile in https://www.ietf.org/.

Se address contiene un nome visualizzato e non null è uguale displayName a String.Empty, displayName sostituisce il valore specificato in address.

Si applica a

MailAddress(String, String, Encoding)

Origine:
MailAddress.cs
Origine:
MailAddress.cs
Origine:
MailAddress.cs

Inizializza una nuova istanza della classe MailAddress utilizzando l'indirizzo, il nome visualizzato e la codifica specificati.

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)

Parametri

address
String

Oggetto String che contiene un indirizzo di posta elettronica.

displayName
String

Classe String contenente il nome visualizzato associato a address.

displayNameEncoding
Encoding

Classe Encoding che definisce il set di caratteri utilizzato per displayName.

Eccezioni

address è null.

-oppure-

displayName è null.

address è Empty ("").

-oppure-

displayName è Empty ("").

address non è in un formato riconosciuto.

-oppure-

address contiene caratteri non ASCII.

Esempio

Nell'esempio di codice seguente viene usato questo costruttore per creare MailAddress istanze per il mittente di un messaggio di posta elettronica.

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

Commenti

Lo spazio vuoto iniziale e finale nel nome visualizzato viene mantenuto.

Se address contiene un nome visualizzato e non null è uguale displayName a String.Empty, displayName sostituisce il valore specificato in address.

Il MailAddress metodo non verifica se il displayName parametro è valido. Questo metodo rimuove le virgolette circostanti non visualizzate dalla DisplayName proprietà . Le virgolette verranno aggiunte prima della trasmissione, tranne dove ASCII o Unicode è specificato nel displayNameEncoding parametro. La codifica specificata nel displayNameEncoding parametro verrà applicata alla DisplayName proprietà prima della displayNameEncoding trasmissione ASCII o Unicode specificata nel parametro. UTF8 è la codifica predefinita se non è specificato nessuno.

Per altre informazioni sui formati di indirizzi di posta supportati, vedere MailAddress.

Si applica a