Represents the Internet standards and RFCs define header fields which may occur on Internet Mail Messages . More...

Inherits Object.

Public Member Functions

bool Equals (System::SharedPtr< System::Object > obj) override
 Returns a boolean indicating if the passed in object obj is Equal to this.
More...
 
int32_t GetHashCode () const override
 Serves as a hash function for a particular type. More...
 
System::String ToString () const override
 Returns a T:System::String that represents the current T:System::Object. More...
 

Static Public Member Functions

static System::SharedPtr< HeaderTypeget_ApparentlyTo ()
 Inserted by sending e-mail when there is no "To:" recipient in the original message. This causes the recipients derived from the envelope to be listed in the message heading. This behavior is not quite proper, MTAs should not modify headers (except inserting Received lines), and it can in some cases cause Bcc recipients to be wrongly divulged to non-Bcc recipients. Example: Apparently-To: someo.nosp@m.ne@s.nosp@m.omedo.nosp@m.main.nosp@m..com More...
 
static System::SharedPtr< HeaderTypeget_ApprovedBy ()
 Name of the moderator of the mailing list to which this message is sent; necessary on a posting sent to a moderated mailing list to allow its distribution to the list members. Example: Approved-By: someo.nosp@m.ne@s.nosp@m.omedo.nosp@m.main.nosp@m..com More...
 
static System::SharedPtr< HeaderTypeget_Bcc ()
 A copy of the e-mail message that is sent to one or more recipients without the knowledge of the primary recipients. Primary recipients are listed in the To: and Cc: lines. This is useful if you want to copy a message to many people without each of them seeing who the other recipients are. If you see this header on incoming mail, something is wrong because it does not appear in the headers. More...
 
static System::SharedPtr< HeaderTypeget_CC ()
 This header can be considered an extension of the "To:" field as it is used to specifiy additional recipients. In this case, the copy of an e-mail message sent to a recipient has the recipient's address appearing in the message. This is useful if you want to copy a message to many people with each of them seeing who the other recipients are; contrast with Bcc above. This header does appear in incoming e-mail. Exmple: Cc: gboyd.nosp@m.@net.nosp@m.com.c.nosp@m.om More...
 
static System::SharedPtr< HeaderTypeget_DispositionNotificationTo ()
 When the DispositionNotificationTo field is set, a request for a MDN (Message Delivery Notification) is made. The recipient's email software (Outlook, Eudora, etc.) may silently ignore the request, or it may prompt the user for permission to send the MDN. There is no guarantee of the "return-receipt". The DispositionNotificationTo field is the de facto standard for requesting return-receipts (i.e. MDN, or message delivery notifications). More...
 
static System::SharedPtr< HeaderTypeget_ReturnReceiptTo ()
 A sender can request a return-receipt by including this header field. The return-receipt is sent to the Return-Path address of the email and not to the address specified in the Return-Receipt-To header field. This header is non-standard and mostly not supported. Use Disposition-Notification-To instead. Even if supported, there is no guarantee of a receipt being sent. More...
 
static System::SharedPtr< HeaderTypeget_Comments ()
 This is a free-form header field defined in RFC2822. The header is used to place explanatory text into the header portion of an e-mail message. The field may contain arbitrary text. Exmple: Comments: Authenticated sender is someo.nosp@m.ne@s.nosp@m.omedo.nosp@m.nmai.nosp@m.n.com. More...
 
static System::SharedPtr< HeaderTypeget_ContentType ()
 The "Content-Type" defines the format of content (character set etc.) Note that the values for this header are defined in different ways in RFC1049 and in MIME (RFC2045). Look for the MIME-version: header to understand if Content-Type is to be interpreted according to RFC1049 or according to MIME (RFC2045). The MIME definition should be used in generating mail. More...
 
static System::SharedPtr< HeaderTypeget_ContentTransferEncoding ()
 The third of the MIME-related headers. Indicates the coding method used in a MIME message body. It has no direct relevance to the delivery of e-mail, but it affects how MIME compliant mail programs interpret the content of the message. More...
 
static System::SharedPtr< HeaderTypeget_Date ()
 This header specifies a date (and time), normally the date the message was composed and sent. In X.400 mail systems, the time a message was submitted. Some Internet mail systems also use the date when the message was submitted. If this header is omitted by the sender's computer, it might conceivably be added by a mail server or even by some other machine along the route. What you may not know is that the information in the "Date:" line is supplied by the time on the sender's computer, which may or may not be set correctly. Also, the "Date:" header does not normally indicate when the message was sent, but only when it was composed. The date is in the form 3 character day-of-week (Sun - Sat), day number (1-31) dd, 3-character month name, 4-digit year yyyy, followed by time (24-hour) hh:mm:ss and zone zzz format. Time Zone (zzz) is either the 3-character time zone or the local differential in hours and minutes offset from UTC (Universal Time Coordinated - old Greenwich Mean Time). "-" indicates west and "+" indicates east of UTC. No standard Time Zone definitions seem to exist. Many UNIX versions understand a great range of abbreviations, but the most exhaustive list I found was the GNU tar manual Timezone item and documentation for the Perl date manipulation module TIMEZONES. More...
 
static System::SharedPtr< HeaderTypeget_From ()
 This field contains the identity of the person(s) who wished this message to be sent. The message-creation process should default this field to be a single, authenticated machine address, indicating the AGENT (person, system or process) composing the message. If this is not done, the "Sender:" field MUST be present. If the "From:" field IS defaulted this way, the "Sender:" field is optional and is redundant with the "From:" field. More...
 
static System::SharedPtr< HeaderTypeget_FollowupTo ()
 Used in Usenet News to indicate that future discussions (=follow-up) on an article should go to a different set of newsgroups than the replied-to article. The most common usage is when an article is posted to several newsgroups, and further discussions is to take place in only one of them. More...
 
static System::SharedPtr< HeaderTypeget_InReplyTo ()
 Reference to message which this message is a reply to. More...
 
static System::SharedPtr< HeaderTypeget_MessageID ()
 Unique ID of this message. Defined In RFC 822: 4.6.1 ,RFC 1036: 2.1.5. More...
 
static System::SharedPtr< HeaderTypeget_MIMEVersion ()
 An indicator that this message is formatted according to the MIME standard, and an indication of which version of MIME is utilized. More...
 
static System::SharedPtr< HeaderTypeget_Newsgroups ()
 In Usenet News: group(s) to which this article was posted. Some systems provide this header field also in e-mail although it is not standardized there. Unfortunately, the header field can appear in e-mail with three different and contradictory meanings: (a) Indicating the newsgroup recipient of an article/message sent to both e-mail and Usenet News recipients. (b) In a message adressed to some mail to news gateways, indicates the newsgroup(s) that the message is to be posted to. (c) In a personally addressed reply to an article in a news-group, indicating the newsgroup in which this discussion originated. More...
 
static System::SharedPtr< HeaderTypeget_Received ()
 Trace of MTAs which a message has passed. More...
 
static System::SharedPtr< HeaderTypeget_ReturnPath ()
 Used to convey the information from the MAIL FROM envelope attribute in final delivery, when the message leaves the SMTP environment in which "MAIL FROM" is used. /// More...
 
static System::SharedPtr< HeaderTypeget_Sender ()
 The person or agent submitting the message to the network, if other than shown by the From: header field. Should be authenticated, according to RFC 822, but what kind of authentication is not clear. More...
 
static System::SharedPtr< HeaderTypeget_ReplyTo ()
 This header field is meant to indicate where the sender wants replies to go. Unfortunately, this is ambiguous, since there are different kinds of replies, which the sender may wish to go to different addresses. In particular, there are personal replies intended for only one person, and group replies, intended for the whole group of people who read the replied-to message (often a mailing list, anewsgroup name cannot appear here because of different syntax, see "FollowupTo" .). More...
 
static System::SharedPtr< HeaderTypeget_Subject ()
 Title, heading, subject. Often used as thread indicator for messages replying to or commenting on other messages. More...
 
static System::SharedPtr< HeaderTypeget_To ()
 Primary recipients. More...
 
static System::SharedPtr< HeaderTypeget_References ()
 Reference to other related messages. More...
 
static System::SharedPtr< HeaderTypeget_XMailer ()
 Information about the client software of the originator. More...
 
static System::SharedPtr< HeaderTypeget_XConfirmReadingTo ()
 This header requests an automated confirmation notice when the message is received or read. It is typically ignored; presumably some software acts on it. More...
 
static System::SharedPtr< HeaderTypeget_Importance ()
 Gets the importance. More...
 
static System::SharedPtr< HeaderTypeget_Sensitivity ()
 Gets the sensitivity. More...
 
static System::String to_String (System::SharedPtr< HeaderType > type)
 

Protected Member Functions

virtual ~HeaderType ()
 

Detailed Description

Represents the Internet standards and RFCs define header fields which may occur on Internet Mail Messages .

Constructor & Destructor Documentation

◆ ~HeaderType()

virtual Aspose::Email::HeaderType::~HeaderType ( )
protectedvirtual

Member Function Documentation

◆ Equals()

bool Aspose::Email::HeaderType::Equals ( System::SharedPtr< System::Object >  obj)
override

Returns a boolean indicating if the passed in object obj is Equal to this.

Parameters
objThe HeaderType object to compare.
Returns
Returns true if objects are equal, otherwise returns false

◆ get_ApparentlyTo()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_ApparentlyTo ( )
static

Inserted by sending e-mail when there is no "To:" recipient in the original message. This causes the recipients derived from the envelope to be listed in the message heading. This behavior is not quite proper, MTAs should not modify headers (except inserting Received lines), and it can in some cases cause Bcc recipients to be wrongly divulged to non-Bcc recipients. Example: Apparently-To: someo.nosp@m.ne@s.nosp@m.omedo.nosp@m.main.nosp@m..com

Non-standard header that is discouraged in use, mentioned in RFC1211.

◆ get_ApprovedBy()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_ApprovedBy ( )
static

Name of the moderator of the mailing list to which this message is sent; necessary on a posting sent to a moderated mailing list to allow its distribution to the list members. Example: Approved-By: someo.nosp@m.ne@s.nosp@m.omedo.nosp@m.main.nosp@m..com

Non-standard for use in e-mail. Defined in RFC1036.

◆ get_Bcc()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_Bcc ( )
static

A copy of the e-mail message that is sent to one or more recipients without the knowledge of the primary recipients. Primary recipients are listed in the To: and Cc: lines. This is useful if you want to copy a message to many people without each of them seeing who the other recipients are. If you see this header on incoming mail, something is wrong because it does not appear in the headers.

◆ get_CC()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_CC ( )
static

This header can be considered an extension of the "To:" field as it is used to specifiy additional recipients. In this case, the copy of an e-mail message sent to a recipient has the recipient's address appearing in the message. This is useful if you want to copy a message to many people with each of them seeing who the other recipients are; contrast with Bcc above. This header does appear in incoming e-mail. Exmple: Cc: gboyd.nosp@m.@net.nosp@m.com.c.nosp@m.om

◆ get_Comments()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_Comments ( )
static

This is a free-form header field defined in RFC2822. The header is used to place explanatory text into the header portion of an e-mail message. The field may contain arbitrary text. Exmple: Comments: Authenticated sender is someo.nosp@m.ne@s.nosp@m.omedo.nosp@m.nmai.nosp@m.n.com.

◆ get_ContentTransferEncoding()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_ContentTransferEncoding ( )
static

The third of the MIME-related headers. Indicates the coding method used in a MIME message body. It has no direct relevance to the delivery of e-mail, but it affects how MIME compliant mail programs interpret the content of the message.

Defined in RFC2045.

Content-Transfer-Encoding: 8bit Content-transfer-encoding: 7BIT Content-Transfer-Encoding: 7bit Content-Transfer-Encoding: base64 Content-Transfer-Encoding: quoted-printable

◆ get_ContentType()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_ContentType ( )
static

The "Content-Type" defines the format of content (character set etc.) Note that the values for this header are defined in different ways in RFC1049 and in MIME (RFC2045). Look for the MIME-version: header to understand if Content-Type is to be interpreted according to RFC1049 or according to MIME (RFC2045). The MIME definition should be used in generating mail.

Historically, Content-Type field was proposed in RFC1049. In it, Content-Type did not distinguish type and subtype like RFC2045 does.

Example: Content-Type: text/plain; charset="us-ascii" Content-type: text/plain; charset=US-ASCII Content-Type: text/plain; charset="iso-8859-1" Content-Type: text/plain; charset=koi8-r Content-Type: text/plain; charset=unknown-8bit

◆ get_Date()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_Date ( )
static

This header specifies a date (and time), normally the date the message was composed and sent. In X.400 mail systems, the time a message was submitted. Some Internet mail systems also use the date when the message was submitted. If this header is omitted by the sender's computer, it might conceivably be added by a mail server or even by some other machine along the route. What you may not know is that the information in the "Date:" line is supplied by the time on the sender's computer, which may or may not be set correctly. Also, the "Date:" header does not normally indicate when the message was sent, but only when it was composed. The date is in the form 3 character day-of-week (Sun - Sat), day number (1-31) dd, 3-character month name, 4-digit year yyyy, followed by time (24-hour) hh:mm:ss and zone zzz format. Time Zone (zzz) is either the 3-character time zone or the local differential in hours and minutes offset from UTC (Universal Time Coordinated - old Greenwich Mean Time). "-" indicates west and "+" indicates east of UTC. No standard Time Zone definitions seem to exist. Many UNIX versions understand a great range of abbreviations, but the most exhaustive list I found was the GNU tar manual Timezone item and documentation for the Perl date manipulation module TIMEZONES.

Example: Date: Tue, 9 Jan 2001 23:40:00 -0800 Date: Sun, 1 Apr 2001 22:52:04 EDT Date: Mon, 2 Apr 2001 16:02:19 +0200 Date: Fri, 30 Mar 2001 10:47:15 -0800

◆ get_DispositionNotificationTo()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_DispositionNotificationTo ( )
static

When the DispositionNotificationTo field is set, a request for a MDN (Message Delivery Notification) is made. The recipient's email software (Outlook, Eudora, etc.) may silently ignore the request, or it may prompt the user for permission to send the MDN. There is no guarantee of the "return-receipt". The DispositionNotificationTo field is the de facto standard for requesting return-receipts (i.e. MDN, or message delivery notifications).

◆ get_FollowupTo()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_FollowupTo ( )
static

Used in Usenet News to indicate that future discussions (=follow-up) on an article should go to a different set of newsgroups than the replied-to article. The most common usage is when an article is posted to several newsgroups, and further discussions is to take place in only one of them.

Defined in RFC 1036: 2.2.3, not standardized for use in e-mail.

◆ get_From()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_From ( )
static

This field contains the identity of the person(s) who wished this message to be sent. The message-creation process should default this field to be a single, authenticated machine address, indicating the AGENT (person, system or process) composing the message. If this is not done, the "Sender:" field MUST be present. If the "From:" field IS defaulted this way, the "Sender:" field is optional and is redundant with the "From:" field.

Example: From: "Mr. Some One" someo.nosp@m.ne@s.nosp@m.omedo.nosp@m.main.nosp@m..com

◆ get_Importance()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_Importance ( )
static

Gets the importance.

The importance.

◆ get_InReplyTo()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_InReplyTo ( )
static

Reference to message which this message is a reply to.

◆ get_MessageID()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_MessageID ( )
static

Unique ID of this message. Defined In RFC 822: 4.6.1 ,RFC 1036: 2.1.5.

◆ get_MIMEVersion()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_MIMEVersion ( )
static

An indicator that this message is formatted according to the MIME standard, and an indication of which version of MIME is utilized.

Defined in RFC 2045

◆ get_Newsgroups()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_Newsgroups ( )
static

In Usenet News: group(s) to which this article was posted. Some systems provide this header field also in e-mail although it is not standardized there. Unfortunately, the header field can appear in e-mail with three different and contradictory meanings: (a) Indicating the newsgroup recipient of an article/message sent to both e-mail and Usenet News recipients. (b) In a message adressed to some mail to news gateways, indicates the newsgroup(s) that the message is to be posted to. (c) In a personally addressed reply to an article in a news-group, indicating the newsgroup in which this discussion originated.

Defined in RFC 1036: 2.1.3, not standardized and controversial for use in e-mail.

◆ get_Received()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_Received ( )
static

Trace of MTAs which a message has passed.

Defined in RFC 822

◆ get_References()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_References ( )
static

Reference to other related messages.

◆ get_ReplyTo()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_ReplyTo ( )
static

This header field is meant to indicate where the sender wants replies to go. Unfortunately, this is ambiguous, since there are different kinds of replies, which the sender may wish to go to different addresses. In particular, there are personal replies intended for only one person, and group replies, intended for the whole group of people who read the replied-to message (often a mailing list, anewsgroup name cannot appear here because of different syntax, see "FollowupTo" .).

◆ get_ReturnPath()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_ReturnPath ( )
static

Used to convey the information from the MAIL FROM envelope attribute in final delivery, when the message leaves the SMTP environment in which "MAIL FROM" is used. ///

◆ get_ReturnReceiptTo()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_ReturnReceiptTo ( )
static

A sender can request a return-receipt by including this header field. The return-receipt is sent to the Return-Path address of the email and not to the address specified in the Return-Receipt-To header field. This header is non-standard and mostly not supported. Use Disposition-Notification-To instead. Even if supported, there is no guarantee of a receipt being sent.

◆ get_Sender()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_Sender ( )
static

The person or agent submitting the message to the network, if other than shown by the From: header field. Should be authenticated, according to RFC 822, but what kind of authentication is not clear.

◆ get_Sensitivity()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_Sensitivity ( )
static

Gets the sensitivity.

The sensitivity.

◆ get_Subject()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_Subject ( )
static

Title, heading, subject. Often used as thread indicator for messages replying to or commenting on other messages.

◆ get_To()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_To ( )
static

◆ get_XConfirmReadingTo()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_XConfirmReadingTo ( )
static

This header requests an automated confirmation notice when the message is received or read. It is typically ignored; presumably some software acts on it.

◆ get_XMailer()

static System::SharedPtr<HeaderType> Aspose::Email::HeaderType::get_XMailer ( )
static

Information about the client software of the originator.

Example: X-Mailer: Aspose.Email

◆ GetHashCode()

int32_t Aspose::Email::HeaderType::GetHashCode ( ) const
override

Serves as a hash function for a particular type.

Returns
A hash code for the current T:System::Object.

◆ to_String()

static System::String Aspose::Email::HeaderType::to_String ( System::SharedPtr< HeaderType type)
static

◆ ToString()

System::String Aspose::Email::HeaderType::ToString ( ) const
override

Returns a T:System::String that represents the current T:System::Object.

Returns
A T:System::String that represents the current T:System::Object.