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

System.Net.Mail Namespace

.NET Framework 2.0

Note: This namespace is new in the .NET Framework version 2.0.

The System.Net.Mail namespace contains classes used to send electronic mail to a Simple Mail Transfer Protocol (SMTP) server for delivery.

The MailMessage class represents the content of a mail message. The SmtpClient class transmits email to the SMTP host that you designate for mail delivery. You can create mail attachments using the Attachment class.

  Class Description
Public class AlternateView Represents the format to view an email message.
Public class AlternateViewCollection Represents a collection of AlternateView objects.
Public class Attachment Represents an attachment to an e-mail.
Public class AttachmentBase Base class that represents an email attachment. Classes Attachment, Alternateview, and LinkedResource derive from this class.
Public class AttachmentCollection Stores attachments to be sent as part of an e-mail message.
Public class LinkedResource Represents an embedded external resource in an email attachment, such as an image in an HTML attachment.
Public class LinkedResourceCollection Stores linked resources to be sent as part of an e-mail message.
Public class MailAddress Represents the address of an electronic mail sender or recipient.
Public class MailAddressCollection Store e-mail addresses that are associated with an e-mail message.
Public class MailMessage Represents an e-mail message that can be sent using the SmtpClient class.
Public class SmtpClient Allows applications to send e-mail by using the Simple Mail Transfer Protocol (SMTP).
Public class SmtpException Represents the exception that is thrown when the SmtpClient is not able to complete a Send or SendAsync operation.
Public class SmtpFailedRecipientException Represents the exception that is thrown when the SmtpClient is not able to complete a Send or SendAsync operation to a particular recipient.
Public class SmtpFailedRecipientsException The exception that is thrown when e-mail is sent using an SmtpClient and cannot be delivered to all recipients.
Public class SmtpPermission Controls access to Simple Mail Transport Protocol (SMTP) servers.
Public class SmtpPermissionAttribute Controls access to Simple Mail Transport Protocol (SMTP) servers.
  Delegate Description
Public delegate SendCompletedEventHandler Represents the method that will handle the SendCompleted event.
  Enumeration Description
Public enumeration DeliveryNotificationOptions Describes the delivery notification options for e-mail.
Public enumeration MailPriority Specifies the priority of a MailMessage.
Public enumeration SmtpAccess Specifies the level of access allowed to a Simple Mail Transport Protocol (SMTP) server.
Public enumeration SmtpDeliveryMethod Specifies how email messages are delivered.
Public enumeration SmtpStatusCode Specifies the outcome of sending e-mail by using the SmtpClient class.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Consider using System.Web.Mail instead if your application runs on an NT server

Consider using System.Web.Mail instead, and drop the mail in your local mail queue with your current credentials.

In order to avoid the "try 5 times until the external smtp server happens to be awake", you can drop mail in your local queue (it is the file system, and it is not busy, crashed, or otherwise unavailable, or your code wouldn't be running in the first place.

1) If you are connected to the internet, NT will immediately deliver the mail correctly to the recipient's email server with no delays or detours. If the recipient mail server delivers mail instantaneously, the recipient will see your mail, before your finger leaves the keyboard. No settings are necessary; the internet just works...

2) If you go through a proxy, because your firewall prevents you from accessing the internet, or because you want better protection against accidentally sending bad content, your NT mail demon will deliver the mail to the proxy instead. Your mail proxy may require user name and password, and may have restrictions on outgoing email addresses, etc. The proxy will deliver the mail whenever the proxy policies are scheduled.

3) If there is a delivery problem, your mail is left in the outgoing queue until it is successfuly sent.

 

 

***The System.Web.Mail has been depreciated as of v2.0***

History
Embedding an image

I added an example of how to embed (as opposed to attach) an image under LinkedResource class:

 

http://msdnwiki.microsoft.com/en-us/mtpswiki/system.net.mail.linkedresource(VS.80).aspx

 

I'm putting a note here because I myself found it confusing where to look when I wanted to do that, and I think a lot of people likewise have not known where to look for this information.

History