FormView.EditItemTemplate プロパティ
メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。
編集モードの項目用のカスタム コンテンツを取得または設定します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
プロパティ値
FormView コントロールが編集モードの場合のデータ行のカスタム コンテンツを含んだ System.Web.UI.ITemplate。既定値は null で、このプロパティが設定されていないことを示します。
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文<TemplateContainerAttribute(GetType(FormView), BindingDirection.TwoWay)> _ Public Overridable Property EditItemTemplate As ITemplate
Dim instance As FormView Dim value As ITemplate value = instance.EditItemTemplate instance.EditItemTemplate = value
[TemplateContainerAttribute(typeof(FormView), BindingDirection.TwoWay)] public virtual ITemplate EditItemTemplate { get; set; }
[TemplateContainerAttribute(typeof(FormView), BindingDirection::TwoWay)] public: virtual property ITemplate^ EditItemTemplate { ITemplate^ get (); void set (ITemplate^ value); }
/** @property */ public ITemplate get_EditItemTemplate () /** @property */ public void set_EditItemTemplate (ITemplate value)
public function get EditItemTemplate () : ITemplate public function set EditItemTemplate (value : ITemplate)
FormView コントロールが編集モードの場合のデータ行のカスタム コンテンツを含んだ System.Web.UI.ITemplate。既定値は null で、このプロパティが設定されていないことを示します。
解説FormView コントロールは、コントロールの (CurrentMode プロパティで指定された) 現在のモードに基づいて、異なるテンプレートをデータ行に表示します。各モードで使用されるテンプレートを次の表に示します。
EditItemTemplate プロパティを使用して、FormView コントロールが編集モードの場合のデータ行用に独自のユーザー インターフェイス (UI) を定義します。通常、項目編集テンプレートには、ユーザーが既存のレコードの値を更新するための入力コントロールと、レコードを更新したり、更新操作をキャンセルしたりするためのコマンド ボタンが含まれます。
カスタム テンプレートを指定するには、最初に、FormView コントロールの開始タグと終了タグの間に <EditItemTemplate> タグを配置します。その後、<EditItemTemplate> の開始タグと終了タグの間に、テンプレートの内容のリストを記述できます。双方向のバインド式を使用すると、フィールドを入力コントロールに関連付けることができます。これにより、FormView コントロールは、編集モードで、関連付けられた入力コントロールに元のフィールドの値を自動的に表示できます。レコードが更新されると、FormView コントロールは、関連付けられた入力コントロールから更新されたフィールド値を自動的に抽出します。双方向のバインド式の詳細については、「データベースへのバインド」を参照してください。組み込みのキャンセル操作や更新操作を実行するコマンド ボタンを作成するには、CommandName プロパティを次の表の値のいずれかに設定して、コマンド ボタン コントロールをテンプレートに追加します。
使用例編集モードのデータ行用のカスタム テンプレートを定義する方法を次の例に示します。
<%@ Page language="VB" %> <html> <body> <form runat="server"> <h3>FormView Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" emptydatatext="No employees found." runat="server"> <rowstyle backcolor="LightGreen" wrap="false"/> <editrowstyle backcolor="LightBlue" wrap="false"/> <itemtemplate> <table> <tr> <td rowspan="4"> <asp:image id="EmployeeImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b>Name:</b> </td> <td> <%# Eval("FirstName") %> <%# Eval("LastName") %> </td> </tr> <tr> <td> <b>Title:</b> </td> <td> <%# Eval("Title") %> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="Edit" text="Edit" commandname="Edit" runat="server"/> </td> </tr> </table> </itemtemplate> <edititemtemplate> <table> <tr> <td rowspan="4"> <asp:image id="EmployeeEditImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b>Name:</b> </td> <td> <asp:textbox id="FirstNameUpdateTextBox" text='<%# Bind("FirstName") %>' runat="server"/> <asp:textbox id="LastNameUpdateTextBox" text='<%# Bind("LastName") %>' runat="server"/> </td> </tr> <tr> <td> <b>Title:</b> </td> <td> <asp:textbox id="TitleUpdateTextBox" text='<%# Bind("Title") %>' runat="server"/> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="UpdateButton" text="Update" commandname="Update" runat="server"/> <asp:linkbutton id="CancelButton" text="Cancel" commandname="Cancel" runat="server"/> </td> </tr> </table> </edititemtemplate> </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]" updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title Where [EmployeeID]=@EmployeeID" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
<%@ Page language="C#" %> <html> <body> <form runat="server"> <h3>FormView Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" emptydatatext="No employees found." runat="server"> <rowstyle backcolor="LightGreen" wrap="false"/> <editrowstyle backcolor="LightBlue" wrap="false"/> <itemtemplate> <table> <tr> <td rowspan="4"> <asp:image id="EmployeeImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b>Name:</b> </td> <td> <%# Eval("FirstName") %> <%# Eval("LastName") %> </td> </tr> <tr> <td> <b>Title:</b> </td> <td> <%# Eval("Title") %> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="Edit" text="Edit" commandname="Edit" runat="server"/> </td> </tr> </table> </itemtemplate> <edititemtemplate> <table> <tr> <td rowspan="4"> <asp:image id="EmployeeEditImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b>Name:</b> </td> <td> <asp:textbox id="FirstNameUpdateTextBox" text='<%# Bind("FirstName") %>' runat="server"/> <asp:textbox id="LastNameUpdateTextBox" text='<%# Bind("LastName") %>' runat="server"/> </td> </tr> <tr> <td> <b>Title:</b> </td> <td> <asp:textbox id="TitleUpdateTextBox" text='<%# Bind("Title") %>' runat="server"/> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="UpdateButton" text="Update" commandname="Update" runat="server"/> <asp:linkbutton id="CancelButton" text="Cancel" commandname="Cancel" runat="server"/> </td> </tr> </table> </edititemtemplate> </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]" updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title Where [EmployeeID]=@EmployeeID" 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.EditItemTemplate プロパティのページへのリンク
