stl:vote 投票动态元素

用于制作投票功能

声明性语法

<stl:vote voteName="投票名称" isGroup="true/false" 
cellPadding="填充" cellSpacing="间距" columns="列数" runat="server">
  <headerTemplate>
    <!-- 投票顶部显示信息，可以包含提示信息或提交按钮 -->
  </headerTemplate>
  <itemTemplate>
    <!-- 投票项显示信息 -->
  </itemTemplate>
  <footerTemplate>
    <!-- 投票底部显示信息，可以包含提示信息或提交按钮 -->
  </footerTemplate>
  <successTemplate>
    <!-- 投票成功提示信息 -->
  </successTemplate>
  <failureTemplate>
    <!-- 投票失败提示信息 -->
  </failureTemplate>
</stl:vote>

属性列表

下表显示所有属于此元素的属性列表。

属性	可能的取值	默认值	简介
voteName			投票名称，用于调出投票数据
isGroup			是否与其他投票成组显示
	true		成组显示
	false		单独显示
cellPadding			表格填充
cellSpacing			表格间距
columns			显示投票项的列数

注意

<stl:vote>内部拥有多个以template结尾的模板项，模板项能够包含数据，以类似<%# Container.ItemTitle %>的方式显示。

<headerTemplate>和<footerTemplate>中可以包含<%# Container.Title %>，代表整个投票的标题，同时可以包含投票提交按钮，文字按钮可以使用<asp:LinkButton Text="提交" runat="server"></asp:LinkButton>，图片按钮可以使用<asp:ImageButton ImageUrl="botton.gif" runat="server"></asp:ImageButton>，普通按钮可以使用<asp:Button Text="提交" runat="server"></asp:Button>。

<failureTemplate>中可以包含<%# Container.ErrorMessage %>，代表投票失败的原因，如重复投票等。

<itemTemplate>中可以包含以下数据项：

• <%# Container.ItemIndex %>，代表当前投票项的索引，以数字表示。
• <%# Container.ItemTitle %>，代表当前投票项的标题。
• <%# Container.ImageUrl %>，代表当前投票项图片。
• <%# Container.NavigationUrl %>，代表当前投票项的链接地址。
• <%# Container.Color %>，代表当前投票项的显示颜色。
• <%# Container.VoteNum %>，代表当前投票项的被投票数目。

<stl:vote>将循环显示<itemTemplate>项中的数据，从第一个投票项到最后一个投票项；如果是单选投票，可以使用<asp:RadioButton runat="server" Text="<%# Container.ItemTitle %>"></asp:RadioButton> ，如果复选投票，可以使用<asp:CheckBox runat="server" Text="<%# Container.ItemTitle %>"></asp:CheckBox>，同时可以使用上面列出的数据项显示投票的图片等元素。

投票用例请参见 stl:vote 示例