Skip to main content

Name

property Name: string read write;

Example​

procedure LabelRecipient(const Item: TIdEMailAddressItem);
begin
  Item.Name := 'Operations, North';
  // Item.Text will quote the comma-containing display name.
end;

Usage​

Gets or replaces the raw display name that the Text formatter may quote and place before the current address.

Additional Technical Info​

Name is the raw display-name field of TIdEMailAddressItem. Assignment stores the String directly; it does not trim, validate, quote, encode or modify Address.

Reading Text decides how to present the name. If Name is non-empty and does not compare equal to Address under Indy's case-insensitive locale-aware comparison, it is written before the formatted address. Characters outside Indy's ASCII atom-plus-space set cause double-quoting; embedded backslashes and double quotes receive a backslash escape.

If Name and Address compare equal case-insensitively, the formatter suppresses the name and returns only the address representation. This comparison can be affected by process/operating-system locale. The stored Name remains unchanged.

When Address is empty but Name is not, formatted Text becomes the name followed by <> (with quoting as required). That is a formatter artifact, not a valid deliverable mailbox. When both fields are empty, Text is empty.

Assigning Text later clears and reparses both fields, so round-tripping a raw name may normalize whitespace, remove comments, remove quotes or unescape characters. Set Address and Name directly when the fields are already trusted and separated.

The formatter handles RFC-style quoting but not MIME encoded-word generation itself. Downstream mail-header encoding may transform non-ASCII display text; this property alone does not establish an encoding or SMTP compatibility contract. Apply length, control-character and disclosure policies to external names.

The setter is O(n) managed-string assignment and does no I/O. Formatting can scan and concatenate the complete name. The containing item is mutable, normally list-owned and not thread-safe.

The source-reviewed example demonstrates formatter quoting with a fictional name and sends no mail.

External references

Created 2026-07-15