ButtonFieldBase.ShowHeader Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si se muestra la sección de encabezado en un objeto 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 BooleanValor de propiedad
Es true para mostrar la sección de encabezado; en caso contrario, es false. De manera predeterminada, es false.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la ShowHeader propiedad para mostrar la sección de encabezado de un ButtonField objeto en un DetailsView control .
<%@ 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>
Comentarios
Utilice la ShowHeader propiedad para mostrar u ocultar la sección de encabezado de un ButtonFieldBase objeto. Para mostrar la sección de encabezado, establezca la ShowHeader propiedad en true.
Nota:
Algunos controles enlazados a datos (como el GridView control) pueden mostrar u ocultar solo la sección de encabezado completa del control. Estos controles enlazados a datos no admiten la ShowHeader propiedad para un campo de botón individual. Para mostrar u ocultar toda la sección de encabezado de un control enlazado a datos (si está disponible), use la ShowHeader propiedad para el control.
El valor de esta propiedad se almacena en estado de vista.
