B4X
B4X
Clear an Email Object
See more Email Object Examples
Demonstrates the Chilkat Email.Clear method, which removes the current message content — recipients, headers, body representations, attachments, related items, and embedded messages — leaving an empty email object. This example builds a message with a recipient and attachment, clears it, and prints the counts before and after.
Background: Reusing a single
Email object across many operations is efficient, but leftover state from a previous message could leak into the next. Clear resets the object completely, giving you a clean slate — the safe way to start a fresh message without allocating a new object.Chilkat B4X Downloads
' Demonstrates the Clear method, which removes the current message content, including
' recipients, headers, body representations, attachments, related items, and embedded
' messages -- leaving an empty email object.
Dim email As ChilkatEmail
email.Initialize
email.Subject = "A message"
email.Body = "Some body text."
email.AddTo("Bob", "bob@example.com")
email.AddStringAttachment("notes.txt", "Some notes.")
Log("NumTo before clear = " & email.NumTo)
Log("NumAttachments before clear = " & email.NumAttachments)
' Remove all content, resetting the email object.
email.Clear
Log("NumTo after clear = " & email.NumTo)
Log("NumAttachments after clear = " & email.NumAttachments)