Skip to main content

AttachmentCount

property AttachmentCount: Integer read;

Example​

procedure ReadAttachmentCount(const Parts: TIdMessageParts;
  var Value: Variant);
begin
  Parts.CountParts;
  Value := Parts.AttachmentCount;
end;

Usage​

AttachmentCount returns the cached number of parts whose PartType was mptAttachment during the most recent CountParts scan.

Additional Technical Info​

AttachmentCount returns the collection's cached attachment count. CountParts resets the cache and increments it once for every item whose virtual PartType returns mptAttachment.

Reading this property does not inspect the collection. Its initial value is zero, and it can remain stale after parts are added, removed, reassigned or otherwise changed. Call CountParts immediately before reading whenever accuracy matters.

The count is independent of whether an attachment has a filename, Content-ID, readable backing stream/file or successfully encoded data. A related inline attachment can contribute both to this exposed count and to Indy's separate hidden related-part count.

The read is constant-time and has no side effects. The refresh is O(Count), non-transactional and not thread-safe, so do not mutate the collection concurrently. The source-reviewed example follows the required refresh-before-read pattern and was not runtime-tested.

External references

Created 2026-07-15