Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ListView.ItemTemplate propriété

 

Date de publication : novembre 2016

Obtient ou définit le contenu personnalisé pour l’élément de données dans un ListView contrôle.

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

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

Valeur de propriété

Type: System.Web.UI.ITemplate

Objet qui contient le contenu personnalisé pour l’élément de données dans un ListView contrôle. La valeur par défaut, null, indique que cette propriété n'est pas définie.

Utilisez le ItemTemplate propriété pour définir une interface utilisateur personnalisée (interface utilisateur) pour afficher les éléments de données. Le ItemTemplate modèle est requis par le ListView contrôle. Il contient généralement des contrôles pour afficher les valeurs de champ d’un enregistrement. Si vous souhaitez permettre aux utilisateurs de modifier les données, vous ajoutez également habituellement des boutons pour la ItemTemplate modèle de laisser l’utilisateur de sélectionner un enregistrement, basculez en mode édition ou supprimer un enregistrement.

Pour spécifier le modèle personnalisé de façon déclarative, ajoutez un ItemTemplate élément à l’intérieur du ListView contrôle. Vous pouvez ensuite ajouter le contenu du modèle à le ItemTemplate élément. Pour afficher les valeurs de champ de la source de données qui est liée au contrôle, utilisez une expression de liaison de données. Pour plus d'informations, consultez Data-Binding Expressions Overview.

Pour créer des boutons permettant d’exécuter l’instruction select intégrés, supprimer et des opérations de modification, ajoutez un contrôle bouton au modèle. Définir son CommandName propriété l’une des valeurs répertoriées dans le tableau suivant.

Type de bouton

Valeur de CommandName

Méthode delete

"Delete"

Edit

« Modifier »

Select

« Select »

L’exemple suivant montre comment définir un modèle personnalisé pour un élément de données dans le ListView contrôle.

System_CAPS_security Sécurité Remarque

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut 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>

.NET Framework
Disponible depuis 3.5
Retour au début
Afficher: