Erweitern Minimieren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DetailsView.HeaderTemplate-Eigenschaft

Ruft den benutzerdefinierten Inhalt für die Headerzeile in einem DetailsView-Steuerelement ab oder legt diesen fest.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)
[BrowsableAttribute(false)]
[TemplateContainerAttribute(typeof(DetailsView))]
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public virtual ITemplate HeaderTemplate { get; set; }
<asp:DetailsView>
	<HeaderTemplate>ITemplate</HeaderTemplate>
</asp:DetailsView>

Eigenschaftswert

Typ: System.Web.UI.ITemplate
Eine System.Web.UI.ITemplate, die den benutzerdefinierten Inhalt für die Headerzeile enthält. Der Standardwert ist null und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Die Headerzeile wird am oberen Rand des DetailsView-Steuerelements angezeigt, wenn die HeaderText-Eigenschaft oder die HeaderTemplate-Eigenschaft festgelegt ist. Mithilfe der HeaderTemplate-Eigenschaft können Sie eine eigene benutzerdefinierte Benutzeroberfläche für die Headerzeile definieren. Zum Angeben einer benutzerdefinierten Vorlage für die Headerzeile fügen Sie zunächst <HeaderTemplate>-Tags zwischen dem öffnenden und dem schließenden Tag des DetailsView-Steuerelements ein. Anschließend können Sie zwischen dem öffnenden und dem schließenden <HeaderTemplate>-Tag den Inhalt der Vorlage auflisten. Den Stil der Headerzeile können Sie mithilfe der HeaderStyle-Eigenschaft steuern. Alternativ können Sie in der Headerzeile auch einfach Text anzeigen, indem Sie anstelle dieser Eigenschaft die HeaderText-Eigenschaft festlegen.

HinweisHinweis

Wenn sowohl die HeaderText-Eigenschaft als auch die HeaderTemplate-Eigenschaft festlegt sind, hat die HeaderTemplate-Eigenschaft Vorrang.

Im folgenden Codebeispiel wird veranschaulicht, wie die HeaderTemplate-Eigenschaft zum Erstellen einer benutzerdefinierten Headerzeile verwendet wird.



<%@ 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 CustomerDetailView_ItemCreated(Object sender, EventArgs e)
  {

    // Get the header row.
      DetailsViewRow headerRow = CustomerDetailView.HeaderRow;

    // Get the Label control that displays the current page information 
    // from the header row.
    Label pageNum = (Label)headerRow.FindControl("PageNumberLabel");

    if(pageNum != null)
    {
      // Update the Label control with the current page number.
        int page = CustomerDetailView.DataItemIndex + 1;
      pageNum.Text = "Page " + page.ToString ();
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView HeaderTemplate Example</title>
</head>
<body>
    <form id="Form1" runat="server">

      <h3>DetailsView HeaderTemplate Example</h3>

        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneraterows="true"
          allowpaging="true"
          onitemcreated="CustomerDetailView_ItemCreated"   
          runat="server">

          <headerstyle backcolor="Navy"
            forecolor="White"/>

          <pagersettings Mode="NextPreviousFirstLast"/>  

          <headertemplate>

            <table width="100%">            
              <tr>
                <td align="left">
                  <asp:Image id="LogoImage"
                    imageurl="~\images\Logo.jpg"
                    AlternateText="Our logo" 
                    runat="server"/>
                </td>
                <td align="right" valign="bottom">
                  <asp:Label id="PageNumberLabel"
                    font-size="9"
                    forecolor="DodgerBlue"
                    runat="server"/>
                </td>
              </tr>            
            </table>

          </headertemplate>

        </asp:detailsview>

        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"

          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>



.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.