Introdução ao controle DataRepeater (Visual Studio)

Os pacotes de energia de Visual Basic DataRepeater o controle é um contêiner rolável para controles que exibem dados repetidos, por exemplo, linhas em uma tabela de banco de dados. Ele pode ser usado como uma alternativa para o DataGridView o controle quando você precisar de mais controle sobre o layout dos dados. O DataRepeater "se repete" um grupo de controles relacionados com a criação de várias instâncias em um modo de rolagem. Isso permite aos usuários exibir vários registros ao mesmo tempo.

Visão Geral

Em tempo de design, o DataRepeater controle consiste de duas seções. A seção externa é a visor, onde os dados de rolagem serão exibidos em tempo de execução. A seção interna de (superior), conhecida como o o modelo de item, é onde posicionar os controles que serão repetidos em tempo de execução, normalmente um controle para cada campo na fonte de dados. As propriedades e os controles no modelo de item são encapsuladas na ItemTemplate propriedade.

Em tempo de execução, o ItemTemplate é copiado para uma virtual DataRepeaterItem objeto que é usado para exibir os dados quando cada registro é rolado em modo de exibição. Você pode personalizar a exibição de registros individuais na DrawItem evento, por exemplo, realce um campo com base no valor que ele contém. Para obter mais informações, consulte Como: Alterar a aparência de um controle DataRepeater (Visual Studio).

O uso mais comum para um DataRepeater é de controle exibir dados de uma tabela de banco de dados ou outra origem de dados ligados. Além ADO.NET objetos de dados, o DataRepeater controle pode vincular qualquer classe que implementa o IList interface (inclusive arrays), qualquer classe que implementa o IListSource interface, qualquer classe que implementa o IBindingList interface ou qualquer classe que implementa o IBindingListView interface.

Ligação de Dados

Normalmente, realizar a ligação de dados arrastando campos da Fontes de dados janela para o DataRepeater de controle. Para obter mais informações, consulte Como: Exibir os dados vinculados em um controle DataRepeater (Visual Studio).

Ao trabalhar com grandes quantidades de dados, você pode definir o VirtualMode propriedade para True para exibir um subconjunto dos dados disponíveis. Modo virtual requer a implementação de um cache de dados a partir do qual o DataRepeater estiver preenchido, e você deve controlar todas as interações com o cache de dados em tempo de execução. Para obter mais informações, consulte Modo virtual no controle DataRepeater (Visual Studio).

Você também pode exibir controles não acoplados em um DataRepeater de controle. Por exemplo, você pode exibir uma imagem que é repetida em cada item. Para obter mais informações, consulte Como: Exibir os dados não acoplados em um controle DataRepeater (Visual Studio).

Eventos

Os eventos mais importantes para o DataRepeater controle são o DrawItem evento, que é disparado quando novos itens são colocados na exibição, e o CurrentItemIndexChanged o evento, que é disparado quando um item é selecionado. Você pode usar o DrawItem o evento para alterar a aparência do item. Por exemplo, você pode realçar os valores negativos. Use o CurrentItemIndexChanged evento para acessar os valores dos controles quando um item é selecionado.

O DataRepeater controle expõe todos os eventos de controle padrão no Editor de código. No entanto, alguns eventos não devem ser usado. Teclado e eventos de mouse, como KeyDown, Click, e MouseDown não serão gerados em tempo de execução porque a DataRepeater controle propriamente dito nunca tem foco.

O DataRepeaterItem não expõe eventos em tempo de design porque ele é criado somente em tempo de execução. Se você deseja manipular eventos de teclado e mouse, você pode adicionar um Panel o controle para o ItemTemplate em tempo de design e, em seguida, manipular os eventos para o Panel. Para obter mais informações, consulte Solucionando problemas de controle DataRepeater (Visual Studio).

Personalizações

Há várias maneiras para personalizar a aparência e comportamento do DataRepeater o controle, em tempo de execução e em tempo de design. Propriedades podem ser definidas para alterar cores, ocultar ou modificar os cabeçalhos de item, alterar a orientação de vertical para horizontal e muito mais. Para obter mais informações, consulte Como: Alterar a aparência de um controle DataRepeater (Visual Studio), Como: Exibir cabeçalhos de Item em um controle DataRepeater (Visual Studio) e Como: Alterar o Layout de um controle DataRepeater (Visual Studio).

Observe que algumas propriedades se aplicam para o DataRepeater controle propriamente dito, enquanto outros se apliquem somente ao ItemTemplate. Certifique-se de que você tenha a seção correta do controle selecionado antes de definir propriedades. Para obter mais informações, consulte Como: Alterar a aparência de um controle DataRepeater (Visual Studio).

Outras personalizações incluem a capacidade de adicionar ou excluir registros de controle, adicionando recursos de pesquisa e exibindo dados relacionados em um formato de mestre e detalhadas. Para obter mais informações, consulte Como: Desativar a adição e exclusão de itens de DataRepeater (Visual Studio), Como: Pesquisar dados em um controle DataRepeater (Visual Studio) e Como: Criar um formulário mestre/detalhe usando dois controles de DataRepeater (Visual Studio).

Consulte também

Tarefas

Demonstra Passo a passo: Exibindo dados em um controle DataRepeater (Visual Studio)

Solucionando problemas de controle DataRepeater (Visual Studio)

Outros recursos

Controle DataRepeater (Visual Studio)