ListView.InsertItemTemplate ListView.InsertItemTemplate ListView.InsertItemTemplate ListView.InsertItemTemplate Property

Definizione

Ottiene o imposta il contenuto personalizzato per un elemento di inserimento nel controllo ListView.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

Valore della proprietà

Oggetto che contiene il contenuto personalizzato per l'elemento di inserimento nel ListView controllo.An object that contains the custom content for the insert item in the ListView control. Il valore predefinito è null, che indica che la proprietà non è impostata.The default is null, which indicates that this property is not set.

Esempi

Nell'esempio seguente viene illustrato come definire un modello personalizzato per l'elemento di inserimento di ListView un controllo.The following example shows how to define a custom template for the insert item of a ListView control. Questo esempio di codice fa parte di un esempio più ampio fornito ItemInserted per l'evento.This code example is part of a larger example provided for the ItemInserted event.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza.This example has a text box that accepts user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.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>

Commenti

Utilizzare la InsertItemTemplate proprietà per definire un'interfaccia utente personalizzata per l'elemento ListView di inserimento nel controllo.Use the InsertItemTemplate property to define a custom user interface (UI) for the insert item in the ListView control. Viene eseguito il rendering dell'interfaccia utente all'inizio o alla fine degli elementi visualizzati.This UI is rendered either at the start or at the end of the displayed items. È possibile specificare la posizione in cui viene eseguito il InsertItemPosition rendering dell'interfaccia utente utilizzando la proprietà.You specify where the UI is rendered by using the InsertItemPosition property.

Il InsertItemTemplate modello contiene in genere i controlli di input che consentono all'utente di immettere i valori per un nuovo record.The InsertItemTemplate template usually contains the input controls for the user to enter the values for a new record. Contiene in genere anche pulsanti o collegamenti ipertestuali per inserire il record e per annullare l'operazione di inserimento.It also usually contains buttons or hyperlinks to insert the record and to cancel the insert operation.

Per specificare il modello personalizzato in modo dichiarativo InsertItemTemplate , aggiungere un ListView elemento all'interno dell'elemento.To specify the custom template declaratively, add an InsertItemTemplate element inside the ListView element. È quindi possibile aggiungere il contenuto del modello all' InsertItemTemplate elemento.You can then add the contents of the template to the InsertItemTemplate element. È possibile associare un campo a un controllo di input usando un'espressione di associazione bidirezionale.You can associate a field with an input control by using a two-way binding expression. Quando viene inserito un record, il ListView controllo estrae automaticamente il valore del campo dal controllo di input associato.When a record is inserted, the ListView control automatically extracts the field value from the associated input control. Per altre informazioni, vedere Cenni preliminari sulle espressioni di associazione dati.For more information, see Data-Binding Expressions Overview.

Per creare pulsanti che eseguono operazioni di annullamento e inserimento predefinite, aggiungere un controllo Button al modello.To create buttons that perform the built-in cancel and insert operations, add a button control to the template. Impostarne CommandName la proprietà su uno dei valori elencati nella tabella seguente.Set its CommandName property to one of the values listed in the following table.

TipoButton type Valore CommandNameCommandName value
AnnullaCancel Annullare"Cancel"
INSInsert Inserire"Insert"

È possibile controllare la posizione dell'elemento di inserimento nel ListView controllo utilizzando la InsertItemPosition proprietà.You can control the position of the insert item in the ListView control by using the InsertItemPosition property.

Si applica a

Vedi anche