ButtonFieldBase.ShowHeader 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置一个值，该值指示是否显示 ButtonFieldBase 对象的标头部分。
public:
virtual property bool ShowHeader { bool get(); void set(bool value); };public override bool ShowHeader { get; set; }member this.ShowHeader : bool with get, setPublic Overrides Property ShowHeader As Boolean属性值
如果为 true，则显示标头部分，否则为 false。 默认值为 false。
示例
下面的代码示例演示如何使用ShowHeader属性在控件中DetailsView显示对象的标头部分ButtonField。
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void ProductsDetailsView_ItemCommand(Object sender, DetailsViewCommandEventArgs e)
{
if(e.CommandName == "Add")
{
// Retrieve the current author's last name. In this example, the
// last name is displayed in the second cell (index 1) of the
// second row (index 1).
string lastName = ProductsDetailsView.Rows[1].Cells[1].Text;
// Create a ListItem object to represent the author.
ListItem item = new ListItem(lastName);
// Add the ListItem to the list box control if it does not
// already appear in the ListBox.
if(!ProductsListBox.Items.Contains(item))
{
ProductsListBox.Items.Add(item);
}
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ButtonFieldBase ShowHeader Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ButtonFieldBase ShowHeader Example</h3>
Click the Add button to add the product to the list box.
<table cellpadding="30">
<tr>
<td>
<!-- Set the ShowHeader property of the ButtonField -->
<!-- declaratively to display the header section in -->
<!-- that row. -->
<asp:detailsview id="ProductsDetailsView"
datasourceid="ProductsSqlDataSource"
autogeneraterows="false"
allowpaging="true"
gridlines="both"
onitemcommand="ProductsDetailsView_ItemCommand"
runat="server">
<Fields>
<asp:buttonfield buttontype="Link"
commandname="Add"
headertext="Add Product"
showheader="true"
text="Add"/>
<asp:boundfield datafield="ProductID"
headertext="ID"/>
<asp:boundfield datafield="ProductName"
headertext="Product"/>
</Fields>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="ProductsSqlDataSource"
selectcommand="SELECT ProductName, ProductID FROM Products"
connectionstring="<%$ ConnectionStrings:NorthwindConnection %>"
runat="server">
</asp:sqldatasource>
</td>
<td>
Products List:<br/>
<asp:listbox id="ProductsListBox"
runat="server"/>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub ProductsDetailsView_ItemCommand(ByVal sender As Object, ByVal e As DetailsViewCommandEventArgs)
If e.CommandName = "Add" Then
' Retrieve the current author's last name. In this example, the
' last name is displayed in the second cell (index 1) of the
' second row (index 1).
Dim lastName As String = ProductsDetailsView.Rows(1).Cells(1).Text
' Create a ListItem object to represent the author.
Dim item As ListItem = New ListItem(lastName)
' Add the ListItem to the list box control if it does not
' already appear in the ListBox.
If Not ProductsListBox.Items.Contains(item) Then
ProductsListBox.Items.Add(item)
End If
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ButtonFieldBase ShowHeader Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ButtonFieldBase ShowHeader Example</h3>
Click the Add button to add the product to the list box.
<table cellpadding="30">
<tr>
<td>
<!-- Set the ShowHeader property of the ButtonField -->
<!-- declaratively to display the header section in -->
<!-- that row. -->
<asp:detailsview id="ProductsDetailsView"
datasourceid="ProductsSqlDataSource"
autogeneraterows="false"
allowpaging="true"
gridlines="both"
onitemcommand="ProductsDetailsView_ItemCommand"
runat="server">
<Fields>
<asp:buttonfield buttontype="Link"
commandname="Add"
headertext="Add Product"
showheader="true"
text="Add"/>
<asp:boundfield datafield="ProductID"
headertext="ID"/>
<asp:boundfield datafield="ProductName"
headertext="Product"/>
</Fields>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="ProductsSqlDataSource"
selectcommand="SELECT ProductName, ProductID FROM Products"
connectionstring="<%$ ConnectionStrings:NorthwindConnection %>"
runat="server">
</asp:sqldatasource>
</td>
<td>
Products List:<br/>
<asp:listbox id="ProductsListBox"
runat="server"/>
</td>
</tr>
</table>
</form>
</body>
</html>
注解
ShowHeader使用属性显示或隐藏对象的标头部分ButtonFieldBase。 若要显示标头部分，请将 ShowHeader 属性设置为 true.
备注
某些数据绑定控件 (（如 GridView 控件) ）只能显示或隐藏控件的整个标头部分。 这些数据绑定控件不支持 ShowHeader 单个按钮字段的属性。 若要显示或隐藏数据绑定控件的整个标头部分（如果可用) ），请使用 ShowHeader 控件的属性 (。
此属性的值以视图状态存储。