<CSBlog:WeblogList />
List control providing access to Weblog objects.
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
<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
Form control that provides support for contacting the owner of the current Weblog.
Form control that provides support for managing the accessing-users email subscriptions for the current Weblog.
Form control to create and execute a search query witin the current Weblog.
Override of the Image control which processes the Application Root escape (~/) in the ImageUrl and DescriptionUrl as the root of the current blog theme.
Override of the Script control that interprets the '~/' Src modifier as the root of the current blog theme.
Override of the Style control that resolves the '~/' Href modifier as the root of the current blog theme.
Calendar containing links on days where a post was made on the current Weblog.
Single value control that provides access to Weblog data and links.
List control providing access to Weblog objects.
Condition control that checks the accessing user's permissions on the current Weblog.
Condition control that provides support for comparing two properties of a Weblog object.
Condition control that provides support for comparing a property of a Weblog object to a static value.