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.

ListView.EditItemTemplate-Eigenschaft

.NET Framework 4.5

Andere Versionen

Ruft den benutzerdefinierten Inhalt des Elements im Bearbeitungsmodus ab oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)

Syntax

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>

Eigenschaftswert

Typ: System.Web.UI.ITemplate
Ein Objekt, das den benutzerdefinierten Inhalt für das Element im Bearbeitungsmodus enthält. Der Standardwert ist null und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Hinweise

Definieren Sie mithilfe der EditItemTemplate-Eigenschaft eine benutzerdefinierte Benutzeroberfläche (UI) für das Element im Bearbeitungsmodus. Die EditItemTemplate-Vorlage enthält normalerweise die Eingabesteuerelemente, mit denen Benutzer die Werte eines vorhandenen Datensatzes aktualisieren können. Normalerweise enthält sie auch Schaltflächen, mit denen der Datensatz aktualisiert und der Aktualisierungsvorgang abgebrochen werden kann.

Wenn Sie die benutzerdefinierte Vorlage deklarativ angeben möchten, fügen Sie ein EditItemTemplate-Element im ListView-Steuerelement hinzu. Fügen Sie anschließend dem EditItemTemplate-Element den Inhalt und die Steuerelemente für die Vorlage hinzu. Sie können einem Eingabesteuerelement mithilfe eines bidirektionalen Bindungsausdrucks ein Feld zuordnen. Dies ermöglicht es dem ListView-Steuerelement, automatisch den ursprünglichen Feldwert des zugeordneten Eingabesteuerelements für das Element im Bearbeitungsmodus anzuzeigen. Beim Aktualisieren eines Datensatzes kann das ListView-Steuerelement den aktualisierten Feldwert automatisch aus dem zugeordneten Eingabesteuerelement extrahieren. Weitere Informationen finden Sie unter Data-Binding Expression Syntax.

Fügen Sie der Vorlage ein Schaltflächen-Steuerelement hinzu, um Schaltflächen zu erstellen, mit denen integrierte Abbruch- und Aktualisierungsvorgänge ausgeführt werden können. Legen Sie die zugehörige CommandName-Eigenschaft auf einen der in der folgenden Tabelle aufgelisteten Werte fest.

Schaltflächentyp	CommandName-Wert
Abbrechen	"Cancel"
Aktualisieren	"Update"

Beispiele

Das folgende Beispiel veranschaulicht, wie Sie eine benutzerdefinierte Vorlage für das Element im Bearbeitungsmodus definieren.

Sicherheitshinweis
In diesem Beispiel ist ein Textfeld für eine Benutzereingabe enthalten. Dies stellt ein potenzielles Sicherheitsrisiko dar. Standardmäßig stellt die ASP.NET-Seite sicher, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter 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>

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5

Plattformen

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.

Siehe auch