Home Library Learn Downloads Support Community
Sign in | United States - English | |
1 out of 8 rated this helpful - Rate this topic

MailMessage.To Property

.NET Framework 3.0
Gets the address collection that contains the recipients of this e-mail message.

Namespace: System.Net.Mail
Assembly: System (in system.dll)

C#
C++
VB
Copy 
public MailAddressCollection To { get; }
J#
Copy 
/** @property */
public MailAddressCollection get_To ()
JScript
Copy 
public function get To () : MailAddressCollection
XAML
Copy 
Not applicable.

Property Value

A writable MailAddressCollection object.

The To property is used to designate the addresses on the To line of an e-mail message. To add a recipient to an e-mail message, create a MailAddress for the recipient's address, and then add that object to the collection returned by this property.

The following code example demonstrates setting the To property.

C#
Copy 
public static void CreateTestMessage4(string server)
{
    MailAddress from = new MailAddress("ben@contoso.com");
    MailAddress to = new MailAddress("Jane@contoso.com");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an e-mail message from an application very easily.";
    SmtpClient client = new SmtpClient(server);
    Console.WriteLine("Sending an e-mail message to {0} by using SMTP host {1} port {2}.",
         to.ToString(), client.Host, client.Port);
    client.Send(message);
}

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
How to send to a list of recipients


It would be much clearer if the sample code included a list of recipients, instead of just one destination mail address.

The following variation on the original sample code indicates how to send to a list of recipients:

  
  public static void CreateTestMessage4(string server)
  {
      MailAddress from = new MailAddress("Ben@contoso.com");
      MailAddress to1 = new MailAddress("Jane@contoso.com");
      MailAddress to2 = new MailAddress("Peter@contoso.com");
      MailAddress to3 = new MailAddress("Linda@contoso.com");
   
      MailMessage message = new MailMessage();
      message.From = from;
      message.To.Add(to1);
      message.To.Add(to2);
      message.To.Add(to3);
      message.Subject = "Using the SmtpClient class.";
      message.Body = @"Using this feature, you can send an e-mail message from an application very easily.";
      SmtpClient client = new SmtpClient(server);
      Console.WriteLine("Sending an e-mail message to {0} by using SMTP host {1} port {2}.",
           to.ToString(), client.Host, client.Port);
      client.Send(message);
  }
History