¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
ItemInserted (Evento)

ListView.ItemInserted (Evento)

Actualización: noviembre 2007

Se produce cuando se solicita una operación de inserción, después de que el control ListView haya insertado el elemento en el origen de datos.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web.Extensions (en System.Web.Extensions.dll)

public event EventHandler<ListViewInsertedEventArgs> ItemInserted
/** @event */
public void add_ItemInserted (EventHandler<ListViewInsertedEventArgs> value)
/** @event */
public void remove_ItemInserted (EventHandler<ListViewInsertedEventArgs> value)

JScript no admite eventos.
<asp:ListView OnItemInserted="EventHandler" />

El control ListView provoca el evento ItemInserted cuando se hace clic en un botón Insertar de la plantilla InsertItemTemplate o cuando se llama al método InsertNewItem, y después de que el control ListView inserte el elemento en el origen de datos. (Un botón Insertar es un control de botón cuya propiedad CommandName está establecida en el valor "Insert".) Esto le permite ejecutar una rutina personalizada cada vez que se produce este evento, como comprobar los resultados de una operación de inserción.

Se pasa un objeto ListViewInsertedEventArgs al controlador de eventos, que le permite determinar el número de registros afectados. También le permite determinar qué excepciones pueden haberse producido. Para determinar el número de registros afectados por la operación de inserción, utilice la propiedad AffectedRows. Para determinar si se han producido excepciones, utilice la propiedad Exception. También puede indicar si la excepción se controló en el controlador de eventos estableciendo la propiedad ExceptionHandled. Si desea obtener acceso a los valores del registro insertado, utilice la propiedad Values.

Si la propiedad AffectedRows notifica que no se insertó ningún elemento, puede volver a enlazar los valores de inserción a la plantilla InsertItemTemplate estableciendo la propiedad KeepInInsertMode en true.

Para obtener más información sobre el control de eventos, vea Utilizar eventos.

En el ejemplo siguiente, se muestra cómo agregar un controlador de eventos para el evento ItemInserted.

Bb343846.alert_security(es-es,VS.90).gifNota de seguridad:

Este ejemplo tiene un cuadro de texto que acepta datos del usuario y puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.

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

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

<script runat="server">

  void ContactsListView_ItemInserted(Object sender, ListViewInsertedEventArgs e)
  {
    if (e.Exception != null)
    {
      if (e.AffectedRows == 0)
      {
        e.KeepInInsertMode = true;
        Message.Text = "An exception occurred inserting the new Contact. " +
          "Please verify your values and try again.";
      }
      else
        Message.Text = "An exception occurred inserting the new Contact. " +
          "Please verify the values in the newly inserted item.";

      e.ExceptionHandled = true;
    }
  }

  protected void Page_Load(object sender, EventArgs e)
  {
    Message.Text = "";
  }
</script>

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

      <h3>ListViewItemInserted Example</h3>

      <asp:Label ID="Message"
        ForeColor="Red"          
        runat="server"/>
      <br/>

      <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="E-mail" />
              <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>

      <!-- 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], [EmailAddress] 
          FROM Person.Contact"
        InsertCommand="INSERT INTO Person.Contact
          ([FirstName], [LastName], [EmailAddress], [PasswordHash], [PasswordSalt]) 
          Values(@FirstName, @LastName, @EmailAddress, '', '');
          SELECT @ContactID = SCOPE_IDENTITY()">
        <InsertParameters>
          <asp:Parameter Name="FirstName" />
          <asp:Parameter Name="LastName" />
          <asp:Parameter Name="EmailAddress" />
          <asp:Parameter Name="ContactID" Type="Int32" Direction="Output" />
        </InsertParameters>
      </asp:SqlDataSource>

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


Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft