(Xojo Plugin) Explaining the Email FromName, FromAddress, and From Properties

This example explains the email object's FromName, FromAddress, and From properties.

Chilkat Xojo Plugin Download Xojo Plugin for Windows, Linux, Mac OS X, and ARM, ARM64

// The email's FROM name and address can be set in several ways.
// It can include an optional friendly name (which is just a description),
// and it must include an address.

// For example:
Dim email1 As New Chilkat.Email
email1.Subject = "test"
email1.Body = "test"

email1.FromName = "Joe Sample"
email1.FromAddress = "joe.sample@example.com"

// the From property contains both the FromName and FromAddress
// This produces the following output:
// From: "Joe Sample" <joe.sample@example.com>
System.DebugLog("From: " + email1.From)
System.DebugLog("--------------------------------------------------")

// Examine the MIME of the email:
System.DebugLog(email1.GetMime())
System.DebugLog("--------------------------------------------------")

// Output is:

// 	MIME-Version: 1.0
// 	Date: Wed, 16 Nov 2016 12:32:13 -0600
// 	Message-ID: <02B461C6D12FA6686C3151A649ED8D5BBFBE0721@CHILKAT13>
// 	Content-Type: text/plain
// 	Content-Transfer-Encoding: 7bit
// 	X-Priority: 3 (Normal)
// 	Subject: test
// 	From: "Joe Sample" <joe.sample@example.com>
// 	CKX-Bounce-Address: joe.sample@example.com
// 
// 	test

// --------------------------------------------
// Alternatively, the From property can be set, and this 
// implicitly sets the FromName and FromAddress properties.

Dim email2 As New Chilkat.Email
email2.From = "Joe Sample <joe.sample@example.com>"

System.DebugLog("FromName: " + email2.FromName)
System.DebugLog("FromAddress: " + email2.FromAddress)
System.DebugLog("--------------------------------------------------")

System.DebugLog(email2.GetMime())