B4X

Append MIME from a StringBuilder with Flags

Demonstrates the Chilkat Imap.AppendMimeWithFlagsSb method, which uploads MIME contained in a StringBuilder and sets its initial system flags. The first argument is the mailbox, the second is the StringBuilder, and the third through sixth set \Seen, \Flagged, \Answered, and \Draft. This example uploads to Drafts with the draft flag set.

Background: This is the StringBuilder form of AppendMimeWithFlags. Passing the MIME as a StringBuilder avoids copying a large message into an intermediate string and is convenient when you already built or loaded the message into a StringBuilder (for example with LoadFile).

Chilkat B4X Downloads

Download Chilkat for B4X

B4X

Dim success As Boolean = False

'  Demonstrates the Imap.AppendMimeWithFlagsSb method, which uploads MIME contained in a
'  StringBuilder and sets its initial system flags.  The 1st argument is the mailbox, the 2nd
'  is the StringBuilder, and the 3rd through 6th set \Seen, \Flagged, \Answered, and \Draft.

Dim imap As ChilkatImap
imap.Initialize("imap")

imap.Ssl = True
imap.Port = 993

success = imap.Connect("imap.example.com")
If success = False Then
    Log(imap.LastErrorText)
    Return
End If

success = imap.Login("user@example.com", "myPassword")
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


'  Build the email to be uploaded.
Dim email As ChilkatEmail
email.Initialize
email.Subject = "Meeting agenda"
email.From = "Alice <alice@example.com>"
success = email.AddTo("Bob", "bob@example.com")
email.Body = "Let's meet at 10am to review the agenda."

Dim mimeText As String = email.GetMime
If email.LastMethodSuccess = False Then
    Log(email.LastErrorText)
    Return
End If


'  Load the MIME into a StringBuilder.  (A StringBuilder can also be filled via LoadFile.)
Dim sbMime As ChilkatStringBuilder
sbMime.Initialize
sbMime.Append(mimeText)

'  Choose the initial flags.  Named variables make each argument's meaning clear at the call.
Dim seen As Boolean = False
Dim flagged As Boolean = False
Dim answered As Boolean = False
Dim draft As Boolean = True

'  Upload to "Drafts" with the \Draft flag set.
success = imap.AppendMimeWithFlagsSb("Drafts", sbMime, seen, flagged, answered, draft)
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


Log("Appended UID: " & imap.AppendUid)

success = imap.Disconnect
If success = False Then
    Log(imap.LastErrorText)
    Return
End If