MailAddress Costruttori

Origine:

MailAddress.cs

Origine:

MailAddress.cs

Origine:

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)

Parametri

Eccezioni

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.

Origine:

MailAddress.cs

Origine:

MailAddress.cs

Origine:

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)

Parametri

Eccezioni

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.

Origine:

MailAddress.cs

Origine:

MailAddress.cs

Origine:

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)

Parametri

Eccezioni

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.