Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe ListViewDeletedEventArgs

Fornece dados para o evento ItemDeleted.

System.Object
  System.EventArgs
    System.Web.UI.WebControls.ListViewDeletedEventArgs

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

public class ListViewDeletedEventArgs : EventArgs

O tipo ListViewDeletedEventArgs expõe os membros a seguir.

  NomeDescrição
Método públicoListViewDeletedEventArgsInicializa uma nova instância da classe ListViewDeletedEventArgs.
Superior

  NomeDescrição
Propriedade públicaAffectedRowsObtém o número de linhas afetadas pela operação de exclusão.
Propriedade públicaExceptionObtém a exceção, se houver, que foi levantada durante a operação de exclusão.
Propriedade públicaExceptionHandledObtém ou define um valor que indica se uma exceção que foi levantada durante a operação de exclusão foi tratada o manipulador.
Propriedade públicaKeysObtém a chave ou chaves para o item excluído.
Propriedade públicaValuesObtém os valores de campo não-chave para o item excluído.
Superior

  NomeDescrição
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoFinalize Permite um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Superior

O ListView controlar gera a ItemDeleted evento quando um botão de exclusão no controle é clicado ou o DeleteItem método é chamado, mas após o ListView controle exclui o item. (Um botão Delete é um botão cuja CommandName propriedade é definida como 'Delete'.) Isso permite que você fornecer um método de manipulação de eventos que executa uma rotina personalizada sempre que esse evento ocorre, como verificar os resultados de uma operação de exclusão.

A ListViewDeletedEventArgs objeto é passado para o método de manipulação de eventos. Este objeto permite que você determine o número de itens afetados e exceções que podem ter ocorrido. Para determinar o número de itens que foram afetados pela operação de exclusão, use o AffectedRows propriedade. Para determinar se ocorreram quaisquer exceções, use o Exception propriedade. Você pode indicar se você tratou a exceção no método de manipulação de eventos, definindo a ExceptionHandled propriedade.

ObservaçãoObservação

Se ocorrer uma exceção durante a operação de exclusão e a ExceptionHandled propriedade estiver definida como false, o ListView re-throws de controle a exceção.

Para acessar os campos de chave do item excluído, use o Keys propriedade. Para acessar os campos não-chave do item excluído, use o Values propriedade. Para obter uma lista dos valores de propriedade inicial de uma instância da ListViewDeletedEventArgs da classe, consulte a ListViewDeletedEventArgs construtor.

O exemplo a seguir mostra como usar o ListViewDeletedEventArgs objeto para determinar se ocorreu uma exceção durante uma operação de exclusão. O ListViewDeletedEventArgs objeto é passado para o método de manipulação de eventos para o ItemDeleted evento.


<%@ 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 Page_Load()
    {
        Message.Text = String.Empty;
    }

    void ContactsListView_ItemDeleted(Object sender, ListViewDeletedEventArgs e)
    {
        // Determine whether an exception occurred during the delete operation.
        if (e.Exception == null)
        {
            // Ensure that a record was deleted.
            if (e.AffectedRows > 0)
            {
                Message.Text = e.AffectedRows + " item(s) deleted successfully.";
            }
            else
            {
                Message.Text = "No item was deleted.";
            }
        }
        else
        {
            // Insert the code to handle the exception here.

            // Indicate that the exception has been handled.
            e.ExceptionHandled = true;
            Message.Text = "An error occurred during the delete operation.";
        }
    }

</script>

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

      <h3>ListViewDeletedEventArgs Example</h3>

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

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource" 
        DataKeyNames="ContactID"
        OnItemDeleted="ContactsListView_ItemDeleted"  
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" 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>
              <asp:Label ID="EmailLabel" runat="server" Text='<%#Eval("EmailAddress") %>' />
            </td>
            <td>
              <asp:LinkButton ID="DeleteButton" runat="server" 
                CommandName="Delete" 
                Text="Delete" 
                OnClientClick="return confirm('Are you sure?');" />
            </td>
          </tr>
        </ItemTemplate>
      </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"
        DeleteCommand="DELETE FROM Person.Contact WHERE [ContactID] = @ContactID">
        <DeleteParameters>
            <asp:Parameter Name="ContactID" Type="Int32" />
        </DeleteParameters>
      </asp:SqlDataSource>

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


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft