(Xojo Plugin) Rename Email Attachments After Adding

Demonstrates how to rename email attachments after adding but before sending.

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

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

Dim mailman As New Chilkat.MailMan

mailman.SmtpHost = "smtp.my-mail-server.com"
mailman.SmtpUsername = "MY_SMTP_USERNAME"
mailman.SmtpPassword = "MY_SMTP_PASSWORD"
mailman.SmtpSsl = True
mailman.SmtpPort = 465

Dim email As New Chilkat.Email

email.Subject = "This is a test"
email.Body = "This is a test"
email.From = "Chilkat Support <support@chilkatsoft.com>"
Dim success As Boolean
success = email.AddTo("Chilkat Admin","admin@chilkatsoft.com")
// To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

// Add some attachments.
// The AddFileAttachment method returns the value of the content-type it chose for the attachment.
Dim contentType As String
contentType = email.AddFileAttachment("qa_data/jpg/starfish.jpg")
If (email.LastMethodSuccess <> True) Then
    System.DebugLog(email.LastErrorText)
    Return
End If

contentType = email.AddFileAttachment("qa_data/pdf/fishing.pdf")
If (email.LastMethodSuccess <> True) Then
    System.DebugLog(email.LastErrorText)
    Return
End If

// If we save the email to a .eml, we can examine in a text editor.
success = email.SaveEml("qa_output/e1.eml")
If (success = False) Then
    System.DebugLog(email.LastErrorText)
    System.DebugLog("Failed to save .eml")
    Return
End If

// We see the following in the e1.eml
// Notice that Chilkat replaced the full path with just the filename.
// The full local path is not part of the email that gets sent..

// ...
// --------------020807050607070004010609
// Content-Type: image/jpeg; name="starfish.jpg"
// Content-Transfer-Encoding: base64
// Content-Disposition: attachment; filename="starfish.jpg"
// 
// ...
// --------------020807050607070004010609
// Content-Type: application/pdf; name="fishing.pdf"
// Content-Transfer-Encoding: base64
// Content-Disposition: attachment; filename="fishing.pdf"
// ...

// Before sending, each filename can be changed within the email object.
// For example:
success = email.SetAttachmentFilename(0,"orange_starfish.jpg")
success = email.SetAttachmentFilename(1,"tuna_fishing.pdf")

// Look at the new MIME source of the email in a  text editor...
success = email.SaveEml("qa_output/e2.eml")
If (success = False) Then
    System.DebugLog(email.LastErrorText)
    System.DebugLog("Failed to save .eml")
    Return
End If

// You'll see this:

// ...
// --------------020807050607070004010609
// Content-Type: image/jpeg; name="orange_starfish.jpg"
// Content-Transfer-Encoding: base64
// Content-Disposition: attachment; filename="orange_starfish.jpg"
// 
// ...
// --------------020807050607070004010609
// Content-Type: application/pdf; name="tuna_fishing.pdf"
// Content-Transfer-Encoding: base64
// Content-Disposition: attachment; filename="tuna_fishing.pdf"
// ...

// Send the email with the updated filenames..
success = mailman.SendEmail(email)
If (success <> True) Then
    System.DebugLog(mailman.LastErrorText)
    Return
End If

success = mailman.CloseSmtpConnection()
If (success <> True) Then
    System.DebugLog("Connection to SMTP server not closed cleanly.")
End If

System.DebugLog("Mail with attachments sent!")