Partilhar via


Eventos de Controle do Servidor Web GridView

No decorrer da paginação e da atualização de seus dados, o controle GridView dispara uma série de eventos aos quais seu código pode responder.

Eventos GridView

O controle GridView expõe eventos de paginação e classificação e eventos que ocorrem quando a linha atual é criada ou vinculada a dados.Os eventos são também gerados quando um controle de comando, como um controle Button que está incluído como parte do controle GridView foi clicou.A tabela a seguir descreve os eventos expostos pelo controle GridView.

  • RowCommand
    Ocorre quando um botão é clicado no controle GridView.Este evento é frequentemente usado para executar uma tarefa quando um botão é clicado no controle.

  • PageIndexChanging
    Ocorre quando um pager botão é clicado, mas antes do controle GridView executar a operação de paginação.Geralmente este evento é tratado para cancelar a operação de paginação.

  • PageIndexChanged
    Ocorre quando um botão de paginação é clicado, mas antes do controle GridView executar a operação de paginação.Normalmente este evento é tratado quando você precisar executar uma tarefa após o usuário navegar para uma página diferente no controle.

  • SelectedIndexChanging
    Ocorre quando o botão Select de uma linha (um botão com o conjunto de propriedades CommandName para "Selecionar") dentro de um controle GridView é clicado, mas antes do controle GridView executar a operação de seleção.Geralmente este evento é tratado para cancelar a operação de seleção.

  • SelectedIndexChanged
    Ocorre quando o botão Select de uma linha em um controle GridView é clicado, mas após o controle GridView realizar a operação de seleção.Geralmente este evento é tratado para executar uma tarefa depois que uma linha está selecionada no controle.

  • Sorting
    Ocorre quando o hiperlink para classificar uma coluna é clicado, mas antes do controle GridView executar a operação de classificação.Geralmente este evento é tratado para cancelar a operação de classificação ou para executar uma rotina de classificação personalizada.

  • Sorted
    Ocorre quando o hiperlink para classificar uma coluna é clicado, mas depois do controle GridView executar a operação de classificação.Normalmente este evento é tratado para executar uma tarefa após o usuário clicar em um hyperlink para classificar uma coluna.

  • RowDataBound
    Ocorre quando uma linha no controle GridView está vinculada a um registro de dados.Geralmente este evento é tratado para modificar o conteúdo de uma linha quando a linha é ligada a dados.

  • RowCreated
    Ocorre quando uma nova linha é criada no controle GridView.Geralmente este evento é tratado para modificar o layout ou aparência de uma linha quando a linha é criada.

  • RowDeleting
    Ocorre quando o botão Delete de uma linha (um botão com o conjunto de propriedades CommandName para "Excluir") dentro de um controle GridView é clicado, mas antes do controle GridView excluir o registro a partir de fonte de dados.Geralmente este evento é tratado para cancelar a operação de exclusão.

  • RowDeleted
    Ocorre quando o botão Delete de uma linha dentro de em um controle GridView clicado, mas após o controle GridView exclui o registro da fonte de dados.Geralmente este evento é tratado para verificar o resultado da operação de exclusão.

  • RowEditing
    Ocorre quando o botão Edit de uma linha (um botão com o conjunto de propriedades CommandName como "Editar") dentro de um controle GridView é clicado, mas antes do controle GridView entrar no modo de edição.Geralmente este evento é tratado para cancelar a operação de edição.

  • RowCancelingEdit
    Ocorre quando o botão Cancel de uma linha (um botão com o conjunto de propriedades CommandName como "Cancelar") dentro de um controle GridView é clicado, mas antes do controle GridView sair do modo de edição.Geralmente este evento é tratado para interromper a operação de cancelamento.

  • RowUpdating
    Ocorre quando o botão Update de uma linha (um botão com sua propriedade CommandName definido como "Atualização") dentro de um controle GridView é clicado, mas antes do controle GridView atualizar o registro.Geralmente este evento é tratado para cancelar a operação de atualização.

  • RowUpdated
    Ocorre quando o botão Update de uma linha dentro de um GridView controle é clicado, mas após o controle GridView atualizar o registro.Geralmente este evento é tratado para verificar os resultados da operação de atualização.

  • DataBound
    Este evento é herdado do controle BaseDataBoundControl e ocorre após o controle GridView terminar a ligação com a fonte de dados.

Consulte também

Referência

Visão Geral sobre o Controle do Servidor Web GridView