Sender (Email subroutine): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
m (→Usage notes) |
||
Line 40: | Line 40: | ||
and a domain name (a string ending with a period (<tt>.</tt>) | and a domain name (a string ending with a period (<tt>.</tt>) | ||
followed by a domain suffix). | followed by a domain suffix). | ||
'''Note:''' | '''Note:''' | ||
The actual existence of such an address is not validated; merely its form. | The actual existence of such an address is not validated; merely its form. |
Revision as of 22:23, 19 July 2012
Mail sender email address (Email class)
The Sender arguments you provide are
sent to the SMTP server in a "MAIL FROM" command,
and they are also included in the
e-mail content as the "From" mail header.
Syntax
email:Sender( name, [nickname])
Syntax terms
An Email object. | |
name | The e-mail address of the sender. |
nickname | An optional string that contains a familiar name associated
with the mail sender. This nickname appears in the e-mail content as part of the "From:" mail header. |
Usage notes
- The sender's e-mail address is not a required header according to protocol,
It is not an error if you omit the Sender method
(or, the equivalent, if you include a Sender call that has a null address)
in your request.
However, if no Sender value is set, no
From:
header is included in the e-mail content unless you explicitly do so using the AddHeader method. In practice, SMTP servers typically want a validly formed sender e-mail address, and they reject e-mail if an included sender address value does not contain an at sign (@) and a domain name (a string ending with a period (.) followed by a domain suffix). Note: The actual existence of such an address is not validated; merely its form. A null address value is usually acceptable, however. - For Sender method examples, see "Basic e-mail" and "E-mail with attachment".