MailAddress Costruttori

Riferimento

Definizione

Spazio dei nomi:: System.Net.Mail

Assembly:: System.Net.Mail.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: 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

ArgumentNullException

address è null.

ArgumentException

address è Empty ("").

FormatException

address non è in un formato riconosciuto.

Esempio

Nell'esempio di codice seguente viene utilizzato 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 angolari.

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)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: 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

ArgumentNullException

address è null.

ArgumentException

address è Empty ("").

FormatException

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, per la displayName codifica viene usato il set di caratteri iso-8859-1. La codifica di caratteri non ASCII è descritta in RFC 1522, disponibile all'indirizzo https://www.ietf.org/.

Se address contiene un nome visualizzato e non è e displayName non null è uguale a String.Empty, displayName esegue l'override del valore specificato in address.

Si applica a

MailAddress(String, String, Encoding)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: 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

ArgumentNullException

address è null.

-oppure-

displayName è null.

ArgumentException

address è Empty ("").

-oppure-

displayName è Empty ("").

FormatException

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 è e displayName non null è uguale a String.Empty, displayName esegue l'override del 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 displayNameEncoding trasmissione, tranne ASCII dove o Unicode è specificato nel parametro . La codifica specificata nel displayNameEncoding parametro verrà applicata alla proprietà prima della DisplayName trasmissione ASCII o Unicode specificata nel displayNameEncoding parametro . UTF8 è la codifica predefinita se non è specificato alcun valore.

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

Si applica a

MailAddress Costruttori

Definizione

Overload

MailAddress(String)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

MailAddress(String, String)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

MailAddress(String, String, Encoding)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

Commenti e suggerimenti

Risorse aggiuntive