MailMessage.To MailMessage.To MailMessage.To MailMessage.To Property

Definition

Gets the address collection that contains the recipients of this email message.

public:
 property System::Net::Mail::MailAddressCollection ^ To { System::Net::Mail::MailAddressCollection ^ get(); };
public System.Net.Mail.MailAddressCollection To { get; }
member this.To : System.Net.Mail.MailAddressCollection
Public ReadOnly Property To As MailAddressCollection

Property Value

Examples

The following code example demonstrates setting the To property.

static void CreateTestMessage4( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailAddress^ to = gcnew MailAddress( L"Jane@contoso.com" );
   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.";
   SmtpClient^ client = gcnew SmtpClient( server );
   Console::WriteLine( L"Sending an email message to {0} by using SMTP host {1} port {2}.", to, client->Host, client->Port );
   client->Send( message );
   client->~SmtpClient();
}


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 email message from an application very easily.";
	SmtpClient client = new SmtpClient(server);
	Console.WriteLine("Sending an email message to {0} by using SMTP host {1} port {2}.",
		 to.ToString(), client.Host, client.Port);

    try {
	  client.Send(message);
	}
	catch (Exception ex) {
	  Console.WriteLine("Exception caught in CreateTestMessage4(): {0}", 
                  ex.ToString() );			  
  }
}

Remarks

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

Applies to