FormView.HeaderTemplate プロパティ
メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。 FormView コントロールのヘッダー行のユーザー定義コンテンツを取得または設定します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
プロパティ値
ヘッダー行のカスタム コンテンツを含んだ System.Web.UI.ITemplate。既定値は null 参照 (Visual Basic では Nothing) で、このプロパティが設定されていないことを示します。
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文<TemplateContainerAttribute(GetType(FormView))> _ Public Overridable Property HeaderTemplate As ITemplate
Dim instance As FormView Dim value As ITemplate value = instance.HeaderTemplate instance.HeaderTemplate = value
[TemplateContainerAttribute(typeof(FormView))] public virtual ITemplate HeaderTemplate { get; set; }
[TemplateContainerAttribute(typeof(FormView))] public: virtual property ITemplate^ HeaderTemplate { ITemplate^ get (); void set (ITemplate^ value); }
/** @property */ public ITemplate get_HeaderTemplate () /** @property */ public void set_HeaderTemplate (ITemplate value)
public function get HeaderTemplate () : ITemplate public function set HeaderTemplate (value : ITemplate)
ヘッダー行のカスタム コンテンツを含んだ System.Web.UI.ITemplate。既定値は null 参照 (Visual Basic では Nothing) で、このプロパティが設定されていないことを示します。
解説HeaderText プロパティまたは HeaderTemplate プロパティが設定されている場合、FormView コントロールの上部にヘッダー行が表示されます。HeaderTemplate プロパティを使用して、ヘッダー行用に独自のカスタム ユーザー インターフェイス (UI) を定義できます。ヘッダー行のカスタム テンプレートを指定するには、最初に <HeaderTemplate> タグを FormView コントロールの開始タグと終了タグの間に配置します。その後、<HeaderTemplate> の開始タグと終了タグの間に、テンプレートの内容のリストを記述できます。ヘッダー行のスタイルを制御するには、HeaderStyle プロパティを使用します。また、このプロパティの代わりに HeaderText プロパティを設定して、単にヘッダー行にテキストを表示することもできます。
.gif) メモ |
|---|
| HeaderText プロパティと HeaderTemplate プロパティの両方が設定されている場合は、HeaderTemplate プロパティが優先されます。 |
使用例HeaderTemplate プロパティを使用して、ヘッダー行に表示するカスタム テンプレートを定義する方法を次の例に示します。
<%@ Page language="VB" %> <script runat="server"> Sub EmployeeFormView_ItemCreated(ByVal sender As Object, ByVal e As EventArgs) ' Use the HeaderRow property to retrieve the header row. Dim header As FormViewRow = EmployeeFormView.HeaderRow ' Retrieve the HeaderLabel Label control from the header row. Dim headerLabel As Label = CType(header.FindControl("HeaderLabel"), Label) If headerLabel IsNot Nothing Then ' Display the current page number. Dim currentPage As Integer = EmployeeFormView.PageIndex + 1 headerLabel.Text = "Page " & currentPage.ToString() End If End Sub </script> <html> <body> <form id="Form1" runat="server"> <h3>FormView HeaderTemplate Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" onitemcreated="EmployeeFormView_ItemCreated" runat="server"> <headertemplate> <table> <tr> <td> <asp:image id="LogoImage" imageurl="~/Images/LogoImage.jpg" runat="server"/> </td> <td> <asp:label id="HeaderLabel" runat="server"/> </td> </tr> </table> </headertemplate> <headerstyle horizontalalign="Center" forecolor="White" backcolor="LightBlue"/> <itemtemplate> <table> <tr> <td> <asp:image id="EmployeeImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td> <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3> <%# Eval("Title") %> </td> </tr> </table> </itemtemplate> <pagersettings position="Bottom" mode="NextPrevious"/> </asp:formview> <!-- 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="EmployeeSource" selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
<%@ Page language="C#" %> <script runat="server"> void EmployeeFormView_ItemCreated(Object sender, EventArgs e) { // Use the HeaderRow property to retrieve the header row. FormViewRow header = EmployeeFormView.HeaderRow; // Retrieve the HeaderLabel Label control from the header row. Label headerLabel = (Label)header.FindControl("HeaderLabel"); if(headerLabel != null) { // Display the current page number. int currentPage = EmployeeFormView.PageIndex + 1; headerLabel.Text = "Page " + currentPage.ToString(); } } </script> <html> <body> <form runat="server"> <h3>FormView HeaderTemplate Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" onitemcreated="EmployeeFormView_ItemCreated" runat="server"> <headertemplate> <table> <tr> <td> <asp:image id="LogoImage" imageurl="~/Images/LogoImage.jpg" runat="server"/> </td> <td> <asp:label id="HeaderLabel" runat="server"/> </td> </tr> </table> </headertemplate> <headerstyle horizontalalign="Center" forecolor="White" backcolor="LightBlue"/> <itemtemplate> <table> <tr> <td> <asp:image id="EmployeeImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td> <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3> <%# Eval("Title") %> </td> </tr> </table> </itemtemplate> <pagersettings position="Bottom" mode="NextPrevious"/> </asp:formview> <!-- 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="EmployeeSource" selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- FormView.HeaderTemplate プロパティのページへのリンク
