PowerBuilder

Add Multiple To Recipients at Once

Demonstrates the Chilkat Email.AddMultipleTo method, which parses a comma-separated list of mailbox addresses and appends them all to the direct-recipient (To) list. Each entry may include a display name (e.g. Joe <joe@example.com>). This example adds three To recipients in a single call.

Background: The To header holds a message's primary recipients, and email allows any number of them as a comma-separated list. AddMultipleTo parses that standard syntax — accepting both bare addresses and named forms — so when your recipients arrive as one string (from a form field, database column, or config value) you can populate the whole To list in one step instead of calling AddTo per recipient.

Chilkat PowerBuilder Downloads

Download Chilkat for PowerBuilder

PowerBuilder

integer li_rc
oleobject loo_Email

//  Demonstrates the AddMultipleTo method, which parses a comma-separated list of
//  addresses and appends them all to the direct-recipient (To) list.

loo_Email = create oleobject
li_rc = loo_Email.ConnectToNewObject("Chilkat.Email")
if li_rc < 0 then
    destroy loo_Email
    MessageBox("Error","Connecting to COM object failed")
    return
end if
loo_Email.Subject = "Multiple To example"
loo_Email.From = "alice@example.com"

//  Add several To recipients at once.  Each entry may include a display name.
loo_Email.AddMultipleTo("Joe <joe@example.com>, jane@example.com, Bob <bob@example.com>")

Write-Debug "NumTo = " + string(loo_Email.NumTo)


destroy loo_Email