Chameleon Control Documentation | All Controls | All API Classes

<CSBlog:WeblogList />

List control providing access to Weblog objects.
The <CSBlog:WeblogList /> control is a List Control that reports on Weblog data. See more List controls.

Properties/Attributes

Property Type Description
AdPlacement AdPlacementOptions Enumeration
Gets or sets the option defining how to display the AdTemplate in this list.
Option Type Description
PreSecond Enumeration Value Before the second item in the list.
PreSecondAndLast Enumeration Value Before the second item and after the last item in the list.
Seperator Enumeration Value Between each item.
AlternatingSeparator Enumeration Value Between every other item.
PreFooter Enumeration Value After the last item in the list.
None Enumeration Value Ads should not be rendered.
AlternateListItemCssClass String
Gets or sets the alternate list item CSS class.
ContainerId String
The ID of the tag wrapping this control
ControlIdsToHideWhenNotVisible String
Gets or sets the control ids to hide when this list is not visible.
CssClass String
CSS class of the tag wrapping this control
DataSource Object
Gets or sets the data source of the control to render.
HeaderCssClass String
Gets or sets the header CSS class.
HeaderResourceFile String
Gets or sets the header resource file containing the header resource text.
HeaderResourceName String
Gets or sets the name of the header resource text.
HeaderTag WrappedControlTag Enumeration
Gets or sets the list header tag.
Option Type Description
Acronym Enumeration Value
B Enumeration Value
Blockquote Enumeration Value
Caption Enumeration Value
Center Enumeration Value
Dd Enumeration Value
Div Enumeration Value
Dl Enumeration Value
Dt Enumeration Value
Em Enumeration Value
H1 Enumeration Value
H2 Enumeration Value
H3 Enumeration Value
H4 Enumeration Value
H5 Enumeration Value
H6 Enumeration Value
I Enumeration Value
Li Enumeration Value
Ol Enumeration Value
Ul Enumeration Value
P Enumeration Value
Small Enumeration Value
Span Enumeration Value
Strike Enumeration Value
Strong Enumeration Value
Sub Enumeration Value
Sup Enumeration Value
U Enumeration Value
Td Enumeration Value
Th Enumeration Value
Label Enumeration Value
Fieldset Enumeration Value
Legend Enumeration Value
Unknown Enumeration Value
HeaderText String
Gets or sets the header text for the list.
ID String
Gets or sets the programmatic ID of the control. This ID can be used as a reference by other controls.
ItemsPerRow Integer
Gets or sets the items per row. After this number of items, the RowSeparatorTemplate will be rendered. If 0, the RowSeparatorTemplate will not be rendered.
ListCssClass String
Gets or sets the list CSS class.
ListItemCssClass String
Gets or sets the list item CSS class.
ShowHeaderFooterOnNone Boolean
Gets or sets a value indicating whether to show the HeaderTemplate and TrailerTemplate when no items are bound to this list.
Tag WrappedControlTag Enumeration
The WrappedControlTag of the tag wrapping this control
Option Type Description
Acronym Enumeration Value
B Enumeration Value
Blockquote Enumeration Value
Caption Enumeration Value
Center Enumeration Value
Dd Enumeration Value
Div Enumeration Value
Dl Enumeration Value
Dt Enumeration Value
Em Enumeration Value
H1 Enumeration Value
H2 Enumeration Value
H3 Enumeration Value
H4 Enumeration Value
H5 Enumeration Value
H6 Enumeration Value
I Enumeration Value
Li Enumeration Value
Ol Enumeration Value
Ul Enumeration Value
P Enumeration Value
Small Enumeration Value
Span Enumeration Value
Strike Enumeration Value
Strong Enumeration Value
Sub Enumeration Value
Sup Enumeration Value
U Enumeration Value
Td Enumeration Value
Th Enumeration Value
Label Enumeration Value
Fieldset Enumeration Value
Legend Enumeration Value
Unknown Enumeration Value
Visible Boolean
Gets or sets whether this control should be rendered. If set to false, the control will not render.

Inner Properties

<DisplayConditions>...</DisplayConditions>

Defines required conditions that must be met to display this control
Any Condition control can be placed within this inner property. See a list of Condition controls.

<QueryOverrides>...</QueryOverrides>

Overrides from the default implicit query
Property/Attribute Type Description
ApplicationType ApplicationType Enumeration Gets or sets the type of the application for which sections should be retrieved.
Option Type Description
Forum Enumeration Value
Weblog Enumeration Value
Gallery Enumeration Value
GuestBook Enumeration Value
Calendar Enumeration Value
ContentManagement Enumeration Value
FileGallery Enumeration Value
FeedReader Enumeration Value
BlogRoller Enumeration Value
Ads Enumeration Value
Spam Enumeration Value
Hub Enumeration Value
Reporting Enumeration Value
MediaGallery Enumeration Value
Rest Enumeration Value
MyKB Enumeration Value
Wiki Enumeration Value
Newsletter Enumeration Value
Games Enumeration Value
Store Enumeration Value
Installer Enumeration Value
Admin Enumeration Value
Unknown Enumeration Value
All Enumeration Value
ApplyUserSectionFilter Boolean Gets or sets a value indicating whether to apply the accessing user's section filter.
ExcludeSectionApplicationKeys String Gets or sets the comma-separated list of excluded section application keys.
ExcludeSectionIDs String Gets or sets the comma-separated list of excluded section IDs.
FilterBySectionApplicationKeys String Gets or sets the comma-separated list of section application keys with which to filter.
FilterBySectionIDs String Gets or sets the comma-separated list of section IDs with which to filter.
FirstPageOnly Boolean Gets or sets a value indicating if only the first page of results should be loaded.
GroupID Integer Gets or sets the ID of the group for which sections should be retrieved.
ID String Gets or sets the programmatic ID of the control. This ID can be used as a reference by other controls.
IgnoreLanguageFilter Boolean Gets or sets a value indicating whether language filters should be ignored when retrieving sections.
IgnorePermissions Boolean Gets or sets a value indicating whether permissions should be ignored when retrieving sections.
IncludeSubGroupSections Boolean Are we including sections from groups that are children of the current group?
IsAggregate Boolean Gets or sets a value indicating whether this query is retrieving data for an aggregate page.
IsCommunityAggregatedOnly Boolean Gets or sets a value indicating whether only community aggregated sections should be retrieved.
OnlySearchable Boolean Gets or sets a value indicating whether only searchable sections should be retrieved.
PageIndex Integer Gets or sets the index of the page of objects to display. This value is overridden when a PagerID is specified.
Pager IPager Gets or sets the IPager control used to control the current PageIndex.
PagerID String Gets or sets the ID of the IPager control to use to control the current PageIndex. Any Pager control can be referenced. See a list of Pager controls.
PageSize Integer Gets or sets the number of objects to show on a single page.
ParentSectionApplicationKey String Gets or sets the application key of the parent for which sections should be retrieved.
ParentSectionID Integer Gets or sets the ID of the parent for which sections should be retrieved.
RequireSectionIsActive Boolean Gets or sets a value indicating whether retrieved sections must be active.
SectionApplicationKey String Gets or sets the application key of the section to retrieve.
SectionID Integer Gets or sets the ID of the section to retrieve.
SortBy SectionSortBy Enumeration Gets or sets the sorting method.
Option Type Description
SortOrder Enumeration Value
Name Enumeration Value
Thread Enumeration Value
Post Enumeration Value
LastPost Enumeration Value
DateCreated Enumeration Value
TotalPosts Enumeration Value
TotalMembers Enumeration Value
SortOrder SortOrder Enumeration Gets or sets the sort order.
Option Type Description
Ascending Enumeration Value
Descending Enumeration Value
Visible Boolean Gets or sets whether this control should be rendered. If set to false, the control will not render.

Formatting Templates

<AdTemplate>...</AdTemplate>

The template that is used to display an advertisment

<AlternatingItemTemplate>...</AlternatingItemTemplate>

Template to be rendered for every second item in the list.

<FooterTemplate>...</FooterTemplate>

Template to be rendered after all items in the list.

<HeaderTemplate>...</HeaderTemplate>

Template to be rendered before all items in the list.

<ItemTemplate>...</ItemTemplate>

Template to be rendered for every item in the list. If an AlternatingItemTemplate is also defined, the ItemTemplate will be used for every odd-numbered item only.

<LeaderTemplate>...</LeaderTemplate>

Template to be rendered before the content of the control, if the control is rendered.

<NoneTemplate>...</NoneTemplate>

The template that is used to define what is displayed when no items are found.

<RowSeparatorTemplate>...</RowSeparatorTemplate>

The template that is used to render the separator between rows

<SeparatorTemplate>...</SeparatorTemplate>

Template to be rendered between every item in the list.

<TrailerTemplate>...</TrailerTemplate>

Template to be rendered after the content of the control, if the control is rendered.

Example

The following is a simple/minimal example of the <CSBlog:WeblogList /> control:

<CSBlog:WeblogList runat="server" />

The following example shows all of the configurable options of the <CSBlog:WeblogList /> control:

<CSBlog:WeblogList
	AdPlacement="..."
	AlternateListItemCssClass="..."
	ContainerId="..."
	ControlIdsToHideWhenNotVisible="..."
	CssClass="..."
	HeaderCssClass="..."
	HeaderResourceFile="..."
	HeaderResourceName="..."
	HeaderTag="..."
	HeaderText="..."
	ID="..."
	ItemsPerRow="..."
	ListCssClass="..."
	ListItemCssClass="..."
	ShowHeaderFooterOnNone="..."
	Tag="..."
	Visible="..."
	runat="server">
	<AdTemplate>
		...
	</AdTemplate>
	<AlternatingItemTemplate>
		...
	</AlternatingItemTemplate>
	<DisplayConditions>
		...
	</DisplayConditions>
	<FooterTemplate>
		...
	</FooterTemplate>
	<HeaderTemplate>
		...
	</HeaderTemplate>
	<ItemTemplate>
		...
	</ItemTemplate>
	<LeaderTemplate>
		...
	</LeaderTemplate>
	<NoneTemplate>
		...
	</NoneTemplate>
	<QueryOverrides
		ApplicationType="..."
		ApplyUserSectionFilter="..."
		ExcludeSectionApplicationKeys="..."
		ExcludeSectionIDs="..."
		FilterBySectionApplicationKeys="..."
		FilterBySectionIDs="..."
		FirstPageOnly="..."
		GroupID="..."
		ID="..."
		IgnoreLanguageFilter="..."
		IgnorePermissions="..."
		IncludeSubGroupSections="..."
		IsAggregate="..."
		IsCommunityAggregatedOnly="..."
		OnlySearchable="..."
		PageIndex="..."
		PagerID="..."
		PageSize="..."
		ParentSectionApplicationKey="..."
		ParentSectionID="..."
		RequireSectionIsActive="..."
		SectionApplicationKey="..."
		SectionID="..."
		SortBy="..."
		SortOrder="..."
		Visible="..."
		/>
	<RowSeparatorTemplate>
		...
	</RowSeparatorTemplate>
	<SeparatorTemplate>
		...
	</SeparatorTemplate>
	<TrailerTemplate>
		...
	</TrailerTemplate>
</CSBlog:WeblogList>

See Also

<CSBlog:ContactForm />

Form control that provides support for contacting the owner of the current Weblog.

<CSBlog:EmailSubscriptionsForm />

Form control that provides support for managing the accessing-users email subscriptions for the current Weblog.

<CSBlog:SearchForm />

Form control to create and execute a search query witin the current Weblog.

<CSBlog:ThemeImage />

Override of the Image control which processes the Application Root escape (~/) in the ImageUrl and DescriptionUrl as the root of the current blog theme.

<CSBlog:ThemeScript />

Override of the Script control that interprets the '~/' Src modifier as the root of the current blog theme.

<CSBlog:ThemeStyle />

Override of the Style control that resolves the '~/' Href modifier as the root of the current blog theme.

<CSBlog:WeblogCalendar />

Calendar containing links on days where a post was made on the current Weblog.

<CSBlog:WeblogData />

Single value control that provides access to Weblog data and links.

<CSBlog:WeblogList />

List control providing access to Weblog objects.

<CSBlog:WeblogPermissionCondition />

Condition control that checks the accessing user's permissions on the current Weblog.

<CSBlog:WeblogPropertyComparison />

Condition control that provides support for comparing two properties of a Weblog object.

<CSBlog:WeblogPropertyValueComparison />

Condition control that provides support for comparing a property of a Weblog object to a static value.
Valid XHTML 1.0 Transitional Powered by Community Server (Commercial Edition), by Telligent Systems blogmailr enabled
© 2006-2008 Ben Tiedt
Sign in