 | Mail |
Provides methods for IMail object creation.
You should use CreateFromEml(Byte) if you already have an eml data downloaded via Pop3 or Imap client.
You should use other properties and Create method to create message that you'll send using Smtp client.
Inheritance HierarchyNamespace: Limilabs.Mail
Assembly: Mail (in Mail.dll) Version: 3.0.26106.1555
SyntaxThe MailBuilder type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | MailBuilder | Creates new MailBuilder object. |
Properties| Name | Description | |
|---|---|---|
 | Alternatives | Gets the list of all alternative elements. You can use AddAlternative(Byte) or AddAppointment(Appointment) methods to add attachment to this collection. |
| Bcc | Gets the address(es) of others who are to receive this email message ('BCC', Blind Carbon Copy header), even tough the content of the message may not be directed at them. You can use MailBox to represent single mailbox, or MailGroup to represent group of email addresses. BCC header is not rendered when Render method is used, however it is rendered when message is saved using Save(String) method. |
| Cc | Gets the address(es) of others who are to receive this email message ('CC', Carbon Copy header), even tough the content of the message may not be directed at them. You can use MailBox to represent single mailbox, or MailGroup to represent group of email addresses. |
| CreatePlainTextAutomatically | Gets or sets a value indicating if plain text version of a body is extracted from HTML when Html ot Rtf property is set. Default is true. |
| Date | Gets or sets the send date of a email message ('Date' header). If null, Date is set automatically to current date and time when Create method is used. |
| EnvelopeFrom | Gets or sets the address of the sender taken from the SMTP envelope (SMTP "MAIL FROM"). |
| EnvelopeTo | Gets or sets the address of the recipient taken from the SMTP envelope (SMTP "RCTP FROM"). |
| ExtractRfc822Automatically | Gets or sets a value indicating if message (MessageRfc822, MessageGlobal) being a single root should be extracted. Default is true. |
| From | Gets the author(s) of this email message ('From' header). If it's empty, email message is NOT RFC 2822 compliant. |
| Html | Gets or sets HTML version of the email. If value is not empty extracts plain text from HTML and overrides Text property. |
| Importance | Gets or sets the importance of a email message ('Importance' header). Consider using PriorityHigh or PriorityLow methods instead of setting this field. |
| InReplyTo | Gets or sets the id of the parent email message ('In-Reply-To' header). Does not include surrounding brackets (< and >). |
| MessageID | Gets or sets id of a email message ('Message-ID' header). Does not include surrounding brackets (< and >). If not set or set to null generated automatically. |
| MimeConfiguration | Gets MIME configuration (automatic binhex, apple, uue, tnef, rfc822 processing). |
| NonVisuals | Gets the list of all non visual elements. You can use AddAttachment(Byte) method to add attachment to this collection. |
| NotificationTo | Gets the disposition notifications address(es) ('Disposition-Notification-To' header). Consider using RequestReadReceipt method instead of adding addresses to this property. |
| Priority | Gets or sets the priority of a email message ('Priority' header). Consider using PriorityHigh or PriorityLow methods instead of setting this field. |
| ProcessAppleAutomatically | Gets or sets a value indicating if files stored in AppleSingle (ApplicationAppleFile) and AppleDouble (MultipartAppleDouble) entities should be extracted. Default is true. |
| ProcessBinHexAutomatically | Gets or sets a value indicating if file stored in BinHex attachments (ApplicationBinHex) should be extracted. Default is true. |
| ProcessTnefAutomatically | Gets or sets a value indicating if TNEF attachments (winmail.dat) should be processed. TNEF processing extracts attachments and RTF data from TNEF file and removes TNEF from attachments collections afterwards. Default is true. |
| ProcessUueAutomatically | Gets or sets a value indicating if inline UUE attachments should be extracted. Default is true. |
| RcptTo | Gets or sets the address of the recipient taken from the SMTP envelope (SMTP "RCTP FROM"). |
| References | Gets unique ids (MessageID) of the referenced email messages ('References' header). Does not include brackets (< and >). |
| RemoveInlinedUue | Gets or sets a value indicating if text representation of inline UUE attachments should be removed from Text. Default is false. This property has no affect if ProcessUueAutomatically is set to false. |
| ReplyTo | Gets email address(es) to which the author of this email message suggests that replies be sent ('Reply-to' header). You can use MailBox to represent single mailbox, or MailGroup to represent group of email addresses. |
| ReturnPath | Gets or sets return path address ('Return-Path' header). Does not include brackets (< and >). |
| ReturnReceiptTo | Gets return receipt address(es) ('Return-Receipt-To' header). Consider using RequestReadReceipt method instead of adding addresses to this property. |
| Rtf | Gets or sets RTF version of the email. If value is not empty extracts plain text from RTF and overrides Text property. |
| Sender | Gets or sets mailbox of the agent responsible for the actual transmission of this email message ('Sender' header). |
| Sensitivity | Gets or sets the sensitivity of a email message ('Sensitivity' header). |
| SetDefaults | Gets or set the value indicating whether default values (MessageID, Date, Sender) should be set. Default is true. |
| SMIMEConfiguration | Gets or sets S/MIME configuration (automatic decryption, signed message extraction, certificates used for decryption and signature validation). |
| Subject | Gets or sets subject of a message ('Subject' header). |
| Text | Gets or sets plain text version of the email. Please remember that setting Html will override plain text. |
| To | Gets address(es) of the primary recipient(s) of this email message ('To' header). You can use MailBox to represent single mailbox, or MailGroup to represent group of email addresses. |
| Visuals | Gets the list of all visual elements. You can use AddVisual(Byte) method to add attachment to this collection. |
| XConfirmReadingTo | Gets confirm reading address(es) ('X-Confirm-Reading-To' header). Consider using RequestReadReceipt method instead of adding addresses to this property. |
| XEnvelopeFrom | Gets or sets the address of the sender taken from the SMTP envelope (SMTP "MAIL FROM"). |
| XPriority | Gets or sets the X-Priority of this email message ('X-Priority' header) (Outlook specific). Value ranges from "1" to "5" where "1" is the highest priority, "3" is normal, and "5" is the lowest priority. Consider using PriorityHigh or PriorityLow methods instead of setting this field. |
| XRcptTo | Gets or sets the address of the recipient taken from the SMTP envelope (SMTP "RCTP FROM"). |
Methods| Name | Description | |
|---|---|---|
| AddAlternative(Byte) | Adds alternative view for this message. |
| AddAlternative(MimeBase) | Adds alternative view for this message. |
| AddAppointment | Adds specified appointment as alternative view for this message. |
| AddAttachment(Byte) | Adds attachment with specified data. |
| AddAttachment(MimeData) | Adds attachment. |
| AddAttachment(String) | Adds attachment. Data are read from the specified file. |
| AddCustomHeader | Adds custom header that will be added to IMail object after creation. |
| AddVCard | Adds specified VCARD as attachment to this message. |
| AddVisual(Byte) | Adds visual object with specified data. |
| AddVisual(MimeData) | Adds visual object. |
| AddVisual(String) | Adds visual object. Data are read from the specified file. |
| Create | Creates new IMail using builder configuration. |
| CreateFromDocument |
Creates new IMail using specified MIME document.
Obsolete |
| CreateFromEml(Byte) | Creates new IMail using specified eml raw data. |
| CreateFromEml(String) |
Creates new IMail using specified eml raw data string.
Obsolete |
| CreateFromEmlFile | Loads raw eml data from file and creates new IMail object. |
| DKIMSign(ListDKIMSignatureConfiguration) | Signs the message with multiple DKIM (DomainKeys Identified Mail) signatures. |
| DKIMSign(RSACryptoServiceProvider, DKIMSignatureInfo) | Signs the message using DKIM (DomainKeys Identified Mail) signature. You can call this method multiple times to have several DKIM signatures present in the resulting message. |
| DKIMSign(RSACryptoServiceProvider, String, String) | Signs the message using DKIM (DomainKeys Identified Mail) signature. You can call this method multiple times to have several DKIM signatures present in the resulting message. |
| EncryptWith(EncryptionConfiguration) | Encrypts the message using specified encryption configuration. |
| EncryptWith(X509Certificate2) | Encrypts the message using specified certificate. You can call this method multiple times to use several certificates for encryption. General rule is that both sender and receiver should be able to decrypt the message. |
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object) |
| GetHashCode | Serves as the default hash function. (Inherited from Object) |
| GetType | Gets the Type of the current instance. (Inherited from Object) |
| LoadHtml(String) | Sets HTML version of the message. Modifies passed HTML, so that img tags reference inline images. Adds all images that can be found on disk to Visuals collection. Extracts plain text from HTML and overrides Text property. |
| LoadHtml(String, LoadHtmlConfiguration) | Sets HTML version of the message. Modifies passed HTML, so that img tags reference inline images. Adds all images that can be found on disk to Visuals collection. Extracts plain text from HTML and overrides Text property. |
| LoadHtml(String, String) | Sets HTML version of the message. Modifies passed HTML, so that img tags reference inline images. Adds all images that can be found on disk to Visuals collection. Extracts plain text from HTML and overrides Text property. |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object) |
| PriorityHigh | Sets XPriority to 1, Priority to Urgent and Importance to High |
| PriorityLow | Sets XPriority to 5, Priority to NonUrgent and Importance to Low |
| RequestReadReceipt | This method copies From or ReplyTo addresses to all read receipts lists, just before email is created (using Create method). Read receipts are stored using NotificationTo, ReturnReceiptTo and XConfirmReadingTo headers. |
| SignWith(SignatureConfiguration) | Signs the message. |
| SignWith(X509Certificate2) | Signs the message. |
| ToString | Returns a string that represents the current object. (Inherited from Object) |
See Also