Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

ListView.EditItemTemplate, propriété

.NET Framework 4.5

Autres versions

Obtient ou définit le contenu personnalisé de l'élément en mode Édition.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web.Extensions (dans System.Web.Extensions.dll)

Syntaxe

C++

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[TemplateContainerAttribute(typeof(ListViewDataItem), BindingDirection.TwoWay)]
[BrowsableAttribute(false)]
public virtual ITemplate EditItemTemplate { get; set; }

ASP.NET

<asp:ListView>
	<EditItemTemplate>ITemplate</EditItemTemplate>
</asp:ListView>

Valeur de propriété

Type : System.Web.UI.ITemplate
Un objet qui contient le contenu personnalisé pour l'élément en mode Édition. La valeur par défaut, null, indique que cette propriété n'est pas définie.

Notes

Utilisez la propriété EditItemTemplate pour définir une interface utilisateur personnalisée pour l'élément en mode Édition. Le modèle EditItemTemplate contient habituellement les contrôles d'entrée pour permettre à l'utilisateur de mettre à jour les valeurs d'un enregistrement existant. Il contient aussi habituellement des boutons pour mettre à jour l'enregistrement et annuler l'opération de mise à jour.

Pour spécifier le modèle personnalisé de façon déclarative, ajoutez un élément EditItemTemplate à l'intérieur du contrôle ListView. Ajoutez ensuite le contenu et des contrôles pour modèle à l'élément EditItemTemplate. En utilisant une expression de liaison bidirectionnelle, vous pouvez associer un champ à un contrôle d'entrée. Cela permet au contrôle ListView d'afficher automatiquement la valeur d'origine du champ dans le contrôle d'entrée associé pour l'élément en mode Édition. Lorsqu'un enregistrement est mis à jour, le contrôle ListView peut extraire automatiquement la valeur de champ mise à jour du contrôle d'entrée associé. Pour plus d'informations, consultez Data-Binding Expression Syntax.

Pour créer des boutons qui exécutent les opérations intégrées d'annulation et de mise à jour, ajoutez un contrôle bouton au modèle. Affectez à sa propriété CommandName l'une des valeurs répertoriées dans le tableau suivant.

Type de bouton	Valeur de CommandName
Cancel	"Cancel"
Update	"Update"

Exemples

L'exemple suivant montre comment définir un modèle personnalisé pour l'élément en mode édition.

Note de sécurité
Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Script Exploits Overview.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Templates Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Templates Example</h3>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource" 
        DataKeyNames="ContactID"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblProducts">
            <tr runat="server">
              <th runat="server">Action</th>
              <th runat="server">First Name</th>
              <th runat="server">Last Name</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="ContactsDataPager" PageSize="12">
            <Fields>
              <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true"
                FirstPageText="|&lt;&lt; " LastPageText=" &gt;&gt;|"
                NextPageText=" &gt; " PreviousPageText=" &lt; " />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:LinkButton ID="EditButton" runat="Server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="Server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td valign="top">
              <asp:Label ID="LastNameLabel" runat="Server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <EditItemTemplate>
          <tr style="background-color: #ADD8E6">
            <td>
              <asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />&nbsp;
              <asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:TextBox ID="FirstNameTextBox" runat="server" Text='<%#Bind("FirstName") %>' 
                MaxLength="50" /><br />
            </td>
            <td>
              <asp:TextBox ID="LastNameTextBox" runat="server" Text='<%#Bind("LastName") %>' 
                MaxLength="50" /><br />
            </td>
          </tr>
        </EditItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] FROM Person.Contact"
        UpdateCommand="UPDATE Person.Contact
                       SET FirstName = @FirstName, LastName = @LastName
                       WHERE ContactID = @ContactID">
      </asp:SqlDataSource>

    </form>
  </body>
</html>

Informations de version

.NET Framework

Pris en charge dans : 4.5, 4, 3.5

Plateformes

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Voir aussi