ListView.InsertItemTemplate Eigenschaft

Definition

Ruft den benutzerdefinierten Inhalt für ein einzufügendes Element im ListView-Steuerelement ab oder legt diesen fest.Gets or sets the custom content for an insert item in the ListView control.

public:
 virtual property System::Web::UI::ITemplate ^ InsertItemTemplate { System::Web::UI::ITemplate ^ get(); void set(System::Web::UI::ITemplate ^ value); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.ListViewItem), System.ComponentModel.BindingDirection.TwoWay)]
public virtual System.Web.UI.ITemplate InsertItemTemplate { get; set; }
member this.InsertItemTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property InsertItemTemplate As ITemplate

Eigenschaftswert

Ein Objekt, das den benutzerdefinierten Inhalt für das einzufügende Element im ListView-Steuerelement enthält.An object that contains the custom content for the insert item in the ListView control. Der Standardwert ist null und gibt an, dass diese Eigenschaft nicht festgelegt ist.The default is null, which indicates that this property is not set.

Attribute

Beispiele

Im folgenden Beispiel wird gezeigt, wie eine benutzerdefinierte Vorlage für das einfügeelement eines ListView -Steuer Elements definiert wird.The following example shows how to define a custom template for the insert item of a ListView control. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für das ItemInserted -Ereignis bereitgestellt wird.This code example is part of a larger example provided for the ItemInserted event.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.

<asp:ListView ID="ContactsListView" 
  DataSourceID="ContactsDataSource" 
  DataKeyNames="ContactID"
  OnItemInserted="ContactsListView_ItemInserted"  
  InsertItemPosition="LastItem"
  runat="server">
  <LayoutTemplate>
    <table cellpadding="2" border="1" runat="server" id="tblContacts" width="640px">
      <tr runat="server" id="itemPlaceholder" />
    </table>
    <asp:DataPager runat="server" ID="PeopleDataPager" 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 valign="top">
        <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
        <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
      </td>
      <td>&nbsp;
        <asp:Label ID="EmailLabel" runat="server" Text='<%#Eval("EmailAddress") %>' />
      </td>
    </tr>
  </ItemTemplate>
  <InsertItemTemplate>
    <tr style="background-color:#D3D3D3">
      <td valign="top">
        <asp:Label runat="server" ID="FirstNameLabel" 
          AssociatedControlID="FirstNameTextBox" Text="First Name"/>
        <asp:TextBox ID="FirstNameTextBox" runat="server" 
          Text='<%#Bind("FirstName") %>' /><br />
        <asp:Label runat="server" ID="LastNameLabel" 
          AssociatedControlID="LastNameTextBox" Text="Last Name" />
        <asp:TextBox ID="LastNameTextBox" runat="server" 
          Text='<%#Bind("LastName") %>' /><br />
        <asp:Label runat="server" ID="EmailLabel" 
          AssociatedControlID="EmailTextBox" Text="Email" />
        <asp:TextBox ID="EmailTextBox" runat="server" 
          Text='<%#Bind("EmailAddress") %>' />
      </td>
      <td>
        <asp:LinkButton ID="InsertButton" runat="server" 
          CommandName="Insert" Text="Insert" />
      </td>
    </tr>
  </InsertItemTemplate>
</asp:ListView>
<asp:ListView ID="ContactsListView" 
  DataSourceID="ContactsDataSource" 
  DataKeyNames="ContactID"
  OnItemInserted="ContactsListView_ItemInserted"  
  InsertItemPosition="LastItem"
  runat="server">
  <LayoutTemplate>
    <table cellpadding="2" border="1" runat="server" id="tblContacts" width="640px">
      <tr runat="server" id="itemPlaceholder" />
    </table>
    <asp:DataPager runat="server" ID="PeopleDataPager" 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 valign="top">
        <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
        <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
      </td>
      <td>&nbsp;
        <asp:Label ID="EmailLabel" runat="server" Text='<%#Eval("EmailAddress") %>' />
      </td>
    </tr>
  </ItemTemplate>
  <InsertItemTemplate>
    <tr style="background-color:#D3D3D3">
      <td valign="top">
        <asp:Label runat="server" ID="FirstNameLabel" 
          AssociatedControlID="FirstNameTextBox" Text="First Name"/>
        <asp:TextBox ID="FirstNameTextBox" runat="server" 
          Text='<%#Bind("FirstName") %>' /><br />
        <asp:Label runat="server" ID="LastNameLabel" 
          AssociatedControlID="LastNameTextBox" Text="Last Name" />
        <asp:TextBox ID="LastNameTextBox" runat="server" 
          Text='<%#Bind("LastName") %>' /><br />
        <asp:Label runat="server" ID="EmailLabel" 
          AssociatedControlID="EmailTextBox" Text="Email" />
        <asp:TextBox ID="EmailTextBox" runat="server" 
          Text='<%#Bind("EmailAddress") %>' />
      </td>
      <td>
        <asp:LinkButton ID="InsertButton" runat="server" 
          CommandName="Insert" Text="Insert" />
      </td>
    </tr>
  </InsertItemTemplate>
</asp:ListView>

Hinweise

Verwenden Sie InsertItemTemplate die-Eigenschaft, um eine benutzerdefinierte Benutzeroberfläche für das einfügeelement ListView im-Steuerelement zu definieren.Use the InsertItemTemplate property to define a custom user interface (UI) for the insert item in the ListView control. Diese Benutzeroberfläche wird entweder am Anfang oder am Ende der angezeigten Elemente gerendert.This UI is rendered either at the start or at the end of the displayed items. Mithilfe der InsertItemPosition -Eigenschaft geben Sie an, wo die Benutzeroberfläche gerendert wird.You specify where the UI is rendered by using the InsertItemPosition property.

Die InsertItemTemplate Vorlage enthält normalerweise die Eingabe Steuerelemente für den Benutzer, um die Werte für einen neuen Datensatz einzugeben.The InsertItemTemplate template usually contains the input controls for the user to enter the values for a new record. Sie enthält in der Regel auch Schaltflächen oder Hyperlinks zum Einfügen des Datensatzes und zum Abbrechen des Einfügevorgangs.It also usually contains buttons or hyperlinks to insert the record and to cancel the insert operation.

Fügen Sie ein InsertItemTemplate -Element innerhalb des ListView -Elements hinzu, um die benutzerdefinierte Vorlage deklarativ anzugeben.To specify the custom template declaratively, add an InsertItemTemplate element inside the ListView element. Anschließend können Sie den Inhalt der Vorlage InsertItemTemplate dem-Element hinzufügen.You can then add the contents of the template to the InsertItemTemplate element. Sie können ein Feld einem Eingabe Steuerelement zuordnen, indem Sie einen bidirektionalen Bindungs Ausdruck verwenden.You can associate a field with an input control by using a two-way binding expression. Wenn ein Datensatz eingefügt wird, extrahiert ListView das-Steuerelement automatisch den Feldwert aus dem zugeordneten Eingabe Steuerelement.When a record is inserted, the ListView control automatically extracts the field value from the associated input control. Weitere Informationen finden Sie unter Übersicht über Daten Bindungs Ausdrücke.For more information, see Data-Binding Expressions Overview.

Zum Erstellen von Schaltflächen, die die integrierten abbrechen-und Einfügevorgänge ausführen, fügen Sie der Vorlage ein Schaltflächen-Steuerelement hinzu.To create buttons that perform the built-in cancel and insert operations, add a button control to the template. Legen Sie die zugehörige- EigenschaftaufeinenderinderfolgendenTabelleaufgeführtenWertefest.CommandNameSet its CommandName property to one of the values listed in the following table.

SchaltflächentypButton type CommandName-WertCommandName value
AbbrechenCancel Jederzeit"Cancel"
InsertInsert Setze"Insert"

Sie können die Position des einfügeelements im ListView -Steuerelement mithilfe der InsertItemPosition -Eigenschaft steuern.You can control the position of the insert item in the ListView control by using the InsertItemPosition property.

Gilt für:

Siehe auch