NavHelperAppendCount Method (IAppContext, NavTarget, String, String, String, String, String)

Append a record count to the provided NavTarget caption provided in captionText. This method is normally called only when the AppendCount attribute is set on the NavTarget. The appended count may include HTML formatting.

Note that if an error occurs while retrieving the record count that error is suppressed and the count indicator added to the caption will be rendered to indicate that the count could not be obtained.

When adding the count to the caption, various other NavTarget settings affect how the count is presented including:

• The count is retrieved using the IMapper associated with the PageInfo that is the Target for target unless overridden with Navbar_AppendCountMOP.
• If AddParentInfo is specified and non-null, non-blank viewKeyName and viewKeyValue parameters are provided, a parent filter is constructed and added.
• For performance, the count ceiling specified by the Navbar_RecordCountLimit property is used, defaulting to the target PageInfoRecordCountLimit property if not set.
• The CSS class to use on the DOM navigation element is returned in cssClass per the Navbar_CssClass vs. Navbar_CssClassWithItems properties depending on whether or not the count is non-zero.
• The style pairs to use on the DOM navigation element is returned in stylePairs per the Navbar_Style vs. Navbar_StyleWithItems properties depending on whether or not the count is non-zero.

public static int AppendCount(
	IAppContext cxt,
	NavTarget target,
	string viewKeyName,
	string viewKeyValue,
	ref string captionText,
	out string cssClass,
	out string stylePairs
)

Public Shared Function AppendCount ( 
	cxt As IAppContext,
	target As NavTarget,
	viewKeyName As String,
	viewKeyValue As String,
	ByRef captionText As String,
	<OutAttribute> ByRef cssClass As String,
	<OutAttribute> ByRef stylePairs As String
) As Integer