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 控制項的 屬性 (。
此屬性的值會儲存在檢視狀態中。
