View source for AddHeader (Email subroutine)

{{Template:Email:AddHeader subtitle}}

==Syntax==
{{Template:Email:AddHeader syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%email</th>
<td>A previously declared Email object.
</td></tr>
<tr><th>header</th>
<td>A string expression that names an SMTP request
header, such as &amp;ldquo;Reply-To&amp;rdquo; or &amp;ldquo;In-Reply-To.&amp;rdquo;
Header names are case insensitive.
 
Passing multiple occurrences is allowed:
if a like-named header is already present, an additional
occurrence is added.
</td></tr>
<tr><th>value</th>
<td>A string expression that yields a value for the
request header.
 
</td></tr></table>
==Usage notes==
<ul>
<li>Do ''not'' set &amp;ldquo;To:&amp;rdquo; or &amp;ldquo;Cc:&amp;rdquo; headers using this method.
These headers
require special handling and are set using the AddRecipient and AddCc
methods, respectively.
The Mail method will not recognize recipients added with AddHeader.
<li>Do ''not'' set Content-Type headers using this method.
These headers require special handling and are set using parameters on
the SetBody and AddPart methods.
Specifying a header that has a &amp;ldquo;Content-&amp;rdquo; prefix causes a request cancellation.
<li>The SMTP Helper adds a &amp;ldquo;Date:&amp;rdquo; header to an Email object instance by default
if you do not explicitly add one with AddHeader.
If a Date header is present at the time the mail method is invoked,
it is left intact.
The Date header generated by the SMTP Helper uses the system clock (usually GMT),
adjusted by the GMT offset specified in the OS system parameters.
<li>For an example that includes this method, see [[SMTP Helper#Basic e-mail|"Basic e-mail"]].
</ul>
==See also==
{{Template:Email:AddHeader footer}}