RenderUsing Strings

Pattern.RenderUsing strings allow you to specify replacement tokens inside percent symbols (%) to indicate which values should be substituted when the string is constructed. In addition to formatting and rendering the current property value, other information about the MAPI object can be rendered as part of the pattern string.

There are only a few substitution tokens that have special meaning in CDO Rendering. They are listed in the following table.

CDO Rendering Substitution Tokens

Token Rendered value
%kvalue% For numeric properties, the value/1024. Does not include "KB" symbol.
%rowid% Index of row in the rendered table. Ranges from 0 to RowsPerPage – 1.
%obj% PR_ENTRYID or PR_LONGTERM_ENTRYID_FROM_TABLE of object.
%parentobj% PR_PARENT_ENTRYID of the object.
%value% The value of the property being rendered, based on usage of Format object.

In the previous table, output is fixed for all but the %value% token. In other words, the output is directly related to the underlying MAPI object set as the DataSource. For %value%, however, the rendering output changes based on property type and the semantics of the format object containing the pattern string.

For instance, when %value% appears in the ContainerRenderer.LinkPattern string, it is replaced with the entire contents of the table cell before the link.