Sample code for 30+ languages & platforms
PowerShell Requires Chilkat v11.0.0+

Imap.GetMailSize vs Email.Size

Shows how to get the total size of an email, as well as the sizes of the attachments. This can be done when either full-emails or headers-only are downloaded.

Chilkat PowerShell Downloads

PowerShell
Add-Type -Path "C:\chilkat\ChilkatDotNet47-x64\ChilkatDotNet47.dll"

$success = $false

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

$imap = New-Object Chilkat.Imap

#  Connect to an IMAP server.
#  Use TLS
$imap.Ssl = $true
$imap.Port = 993
$success = $imap.Connect("imap.example.com")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

#  Login
$success = $imap.Login("****","****")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

#  Select an IMAP mailbox
$success = $imap.SelectMailbox("Inbox")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

#  Get the message IDs of all the emails in the mailbox
#  We can choose to fetch UIDs or sequence numbers.
$fetchUids = $true
$messageSet = New-Object Chilkat.MessageSet
$success = $imap.QueryMbx("ALL",$fetchUids,$messageSet)
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

#  When downloading headers, each email object contains
#  (obviously) the headers, but the body will be missing.
#  Attachments will not be included.  However, it is
#  possible to get information about the attachments
#  as well as the complete size of the email.
$bundle = New-Object Chilkat.EmailBundle
$headersOnly = $true
$success = $imap.FetchMsgSet($headersOnly,$messageSet,$bundle)
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

#  Loop over the email objects and display information about each:
$email = New-Object Chilkat.Email
$i = 0
$j = 0
$numEmails = $bundle.MessageCount
while ($i -lt $numEmails) {
    $bundle.EmailAt($i,$email)

    #  Display the From and Subject
    $($email.From)
    $($email.Subject)

    #  Display the recipients:
    $j = 0
    while ($j -lt $email.NumTo) {
        $("TO: " + $email.GetToName($j) + ", " + $email.GetToAddr($j))
        $j = $j + 1
    }

    $j = 0
    while ($j -lt $email.NumCC) {
        $("CC: " + $email.GetCcName($j) + ", " + $email.GetCcAddr($j))
        $j = $j + 1
    }

    #  Show the total size of the email, including body and attachments:
    $($email.Size)

    #  When a full email is downloaded, we would use the
    #  email.NumAttachments property in conjunction with the
    #  email.GetMailAttach* methods.
    #  However, when an email object contains only the header,
    #  we need to access the attachment info differently:
    $numAttach = $imap.GetMailNumAttach($email)
    $j = 0
    while ($j -lt $numAttach) {
        $($imap.GetMailAttachFilename($email,$j))
        $attachSize = $imap.GetMailAttachSize($email,$j)
        $("    size = " + $attachSize + " bytes")
        $j = $j + 1
    }

    $("--")

    $i = $i + 1
}

#  Disconnect from the IMAP server.
$success = $imap.Disconnect()