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

Este tópico ainda não foi avaliado como - Avalie este tópico

Classe GridViewUpdatedEventArgs

.NET Framework 4

Outras versões

Provides data for the RowUpdated event.

Hierarquia de herança

System.Object
System.EventArgs
System.Web.UI.WebControls.GridViewUpdatedEventArgs

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

Sintaxe

C++

public class GridViewUpdatedEventArgs : EventArgs

O tipo GridViewUpdatedEventArgs expõe os membros a seguir.

Construtores

	Nome	Descrição
	GridViewUpdatedEventArgs	Initializes a new instance of the GridViewUpdatedEventArgs class.

Início

Propriedades

	Nome	Descrição
	AffectedRows	Obtém o número de linhas afetadas pela operação de atualização.
	Exception	Obtém a exceção (se houver) que foi levantada durante a operação de atualização.
	ExceptionHandled	Obtém ou define um valor que indica se uma exceção que foi levantada durante a operação de atualização foi tratada no evento manipulador.
	KeepInEditMode	Obtém ou define um valor que indica se a GridView controle deve permanecer no modo de edição após uma operação de atualização.
	Keys	Obtém um dicionário que contém os pares de valor do nome de campo de chave para o registro atualizado.
	NewValues	Obtém um dicionário que contém os pares de valor do nome de campo novo para o registro atualizado.
	OldValues	Obtém um dicionário que contém os pares de nome/valor do campo original para o registro atualizado.

Início

Métodos

	Nome	Descrição
	Equals(Object)	Determina se o Object especificado é igual ao Object atual. (Herdado de Object.)
	Finalize	Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
	GetHashCode	Serve como uma função hash para um tipo específico. (Herdado de Object.)
	GetType	Obtém o Type da instância atual. (Herdado de Object.)
	MemberwiseClone	Cria uma cópia superficial do Object atual. (Herdado de Object.)
	ToString	Retorna uma string que representa o objeto atual. (Herdado de Object.)

Início

Comentários

O GridView controle gera a RowUpdated evento quando um botão de atualização no controle é clicado, mas após o GridView controle atualiza o registro. (Um botão de atualização é um botão de controle cuja CommandName for definida como "Update".) Você pode executar uma rotina personalizada sempre que esse evento ocorre, como, por exemplo, verificando os resultados de uma operação de atualização.

Um GridViewUpdatedEventArgs objeto é passado para o manipulador de eventos permite que você determine o número de registros que foram afetados e exceções que podem ter ocorrido. Para determinar o número de registros que foram afetados pela operação de atualização, use o AffectedRows propriedade. Para determinar se qualquer exceção ocorreu, use o Exception propriedade. Você também pode indicar se a exceção foi tratada no evento manipulador, definindo a ExceptionHandled propriedade.

Para acessar os valores de campo de chave para o registro atualizado, use o Keys propriedade. Você pode acessar os valores de campo de não-chave original usando o OldValues propriedade. Você pode acessar os valores de campo de não-chave atualizado usando o NewValues Propriedades.

Por padrão, o GridView o controle retorna ao modo de somente leitura após uma operação de atualização. Quando você manipular uma exceção que ocorreu durante a operação de atualização, você pode manter o GridView o controle no modo de edição, definindo a KeepInEditMode propriedade para true.

Para obter mais informações sobre como manipular eventos, consulte Consumindo Eventos.

Para obter uma lista dos valores de propriedade inicial de uma instância da GridViewUpdatedEventArgs da classe, consulte a GridViewUpdatedEventArgs construtor.

Exemplos

O exemplo a seguir mostra como determinar se ocorreu uma exceção durante uma operação de atualização.



<%@ 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 CustomersGridView_RowUpdated(Object sender, GridViewUpdatedEventArgs e)
  {
    // Use the Exception property to determine whether an exception
    // occurred during the update operation.
    if (e.Exception == null)
    {
      // Sometimes an error might occur that does not raise an 
      // exception, but prevents the update operation from 
      // completing. Use the AffectedRows property to determine 
      // whether the record was actually updated. 
      if (e.AffectedRows == 1)
      {
        // Use the Keys property to get the value of the key field.
        String keyFieldValue = e.Keys["CustomerID"].ToString();

        // Display a confirmation message.
        Message.Text = "Record " + keyFieldValue +
          " updated successfully. ";

        // Display the new and original values.
        DisplayValues((OrderedDictionary)e.NewValues, (OrderedDictionary)e.OldValues);
      }
      else
      {
        // Display an error message.
        Message.Text = "An error occurred during the update operation.";

        // When an error occurs, keep the GridView
        // control in edit mode.
        e.KeepInEditMode = true;
      }
    }
    else
    {
      // Insert the code to handle the exception.
      Message.Text = e.Exception.Message;

      // Use the ExceptionHandled property to indicate that the 
      // exception is already handled.
      e.ExceptionHandled = true;

      e.KeepInEditMode = true;
    }
  }

  void DisplayValues(OrderedDictionary newValues, OrderedDictionary oldValues)
  {

    Message.Text += "<br/></br>";

    // Iterate through the new and old values. Display the
    // values on the page.
    for (int i = 0; i < oldValues.Count; i++)
    {
      Message.Text += "Old Value=" + oldValues[i].ToString() +
        ", New Value=" + newValues[i].ToString() + "<br/>";
    }

    Message.Text += "</br>";

  }

</script>

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

      <h3>GridViewUpdatedEventArgs Example</h3>

      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"
        onrowupdated="CustomersGridView_RowUpdated" 
        runat="server">
      </asp:gridview>

      <br/>

      <asp:label id="Message"
        forecolor="Red"          
        runat="server"/>

      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>

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

Informações sobre versão

.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0

Plataformas

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

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 de sistema do .NET Framework.

Acesso thread-safe

Quaisquer membros static (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.

Consulte também