User-Defined (Custom) Email Header Fields

Download: Chilkat .NET Assemblies

This example shows how to add custom header fields to your email messages.

// The Email.AddHeaderField can be used to add custom header fields
// to an email, or to replace existing header fields.  If a header field with
// the same name already exists, AddHeaderField will replace it.
        private void AddCustomHeaderFields(Chilkat.Email email)
        {
            // In this example, I'll prefix the custom fields with "X-".
            // Custom header field names must follow this rule:
            // 1*<any CHAR, excluding CTLs, SPACE, and ":">
            // In plain English: The field name must be 1 or more characters,
            // and cannot include control chars, SPACE, or ":".
            email.AddHeaderField("X-Company", "Chilkat Software");
            email.AddHeaderField("X-Regarding", "Example Code");

            // There is a special email header field prefix
            // that can be used with Chilkat email: "CKX-"
            // Any header field beginning with the prefix "CKX-" is automatically
            // removed from the email during the sending process.  (Except when
            // sending MIME via SendMime.)
            // This allows you to embed meta-data with your email and save the MIME
            // to a file or to your database.  For example:
            email.AddHeaderField("CKX-Customer-ID", "1234");
            email.SaveEml("customer.eml");

        }

Important: The download for this example does not contain the ChilkatDotNet.dll which
must be downloaded and installed separately at http://www.chilkatsoft.com/downloads.asp.
Once installed, add a reference to the DLL in the project by following the instructions at
http://www.example-code.com/vbdotnet/step2.asp