2.1.3.1.1.20.3 Property: CATEGORIES

  • Article

RFC Reference: [RFC2445] section 4.8.1.2

Number of Instances Allowed: 0+

Format: Text ([RFC2445] section 4.3.11)

Brief Description: A list of categories assigned to the appointment.

Importing to Calendar objects

All instances of the CATEGORIES property SHOULD be parsed into a single array of strings. Several rules apply to the import of categories:

  • All separator characters, semicolon (Unicode character U+003B), comma (Unicode character U+002C), Arabic semicolon (Unicode character U+061B), small semicolon (Unicode character U+FE54), full-width semicolon (Unicode character U+FF1B), SHOULD<104> be removed.

  • All contiguous sequences of whitespace<105> characters SHOULD<106> be truncated to a single space (Unicode character U+0020) character.

  • Whitespace at the start and end of each string SHOULD be trimmed.

  • Strings SHOULD<107> be truncated to a length of 255 WCHARs if the length exceeds 255 WCHARs, but the truncation SHOULD NOT<108> split surrogate pairs.

  • All case-insensitive duplicate occurrences and zero-length strings in the array SHOULD<109> be removed.

The resulting string array is stored in PidNameKeywords ([MS-OXPROPS] section 2.451).

Exporting from Calendar objects

PidNameKeywords SHOULD be exported as a comma-delimited list in the CATEGORIES property.