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

Artigo
08/01/2011

Esta explicação passo a passo fornece um cenário básico de início-a-término para exibir os dados vinculados em um DataRepeater de controle.

Pré-requisito

Esta explicação passo a passo requer um banco de dados de exemplo Northwind.

Se você não tem esse banco de dados em seu computador de desenvolvimento, você pode baixá-lo da Centro de Download da Microsoft. Para obter instruções, consulte Downloading Sample Databases (LINQ to SQL).

Visão Geral

A primeira parte desta explicação passo a passo consiste em quatro tarefas principais:

Criando uma solução.
Adicionando um DataRepeater de controle.
Adicionando uma fonte de dados.
Adicionando controles ligados a dados.

Observação
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações do Visual Studio.

Criando uma solução DataRepeater

Na primeira etapa, você pode criar um projeto e solução.

Para criar uma solução DataRepeater

Sobre o Visual Studio arquivo menu, clique em Novo projeto.
No tipos de projeto painel no Novo projeto caixa de diálogo caixa, expanda Visual Basice, em seguida, clique em Windows.
Clique em Windows Application no painel Templates.
No nome , digite DataRepeaterApp.
Clique em OK.

O Windows Forms Designer abre.
Selecione o formulário no Designer de formulários do Windows. No Propriedades janela, defina a tamanho propriedade para 800, 700.

Adicionando um controle DataRepeater

Nesta etapa, você adicionar um DataRepeater o controle para o formulário.

Para adicionar um controle DataRepeater

No menu Exibir, clique em Caixa de Ferramentas.

A Toolbox abre.
Selecione o Visual Basic PowerPacks guia.
Arraste um DataRepeater controle Form1.
Na janela Properties, defina a local propriedade para 0, 25.
Definir o tamanho propriedade para 460, 600.

Adicionando uma fonte de dados

Nesta etapa, você adicionar uma fonte de dados para o DataRepeater de controle.

Para adicionar uma fonte de dados

No menu Data, clique em Show Data Sources.
Na janela Data Sources, clique em Add New Data Source.
Selecione Database na página Choose a Data Source Type, e clique Next.
Sobre o Choose Your Data Connection de página, execute uma das seguintes etapas:
- Se uma conexão de dados para o banco de dados de exemplo Northwind estiver disponível na lista drop-down, selecione-o.
  
  - ou -
- Clique em Nova conexão para configurar uma nova conexão de dados. Para obter mais informações, consulte How to: Create Connections to SQL Server Databases.
Se o banco de dados exige uma senha, selecione a opção para incluir dados confidenciais, e clique Next.

Observação

Se aparecer uma caixa de diálogo, clique em Sim para salvar o arquivo ao seu projeto.
Clique em próximo sobre o Salvar a seqüência de conexão no arquivo de configuração de aplicativo página.
Expanda o nó Tables na página Choose your Database Objects.
Marque as caixas de seleção ao lado do os clientes e pedidos tabelas e em seguida, clique Concluir.

NorthwindDataSet é adicionado ao seu projeto e o os clientes e pedidos tabelas aparecem na Fontes de dados janela.

Observação
Se aparecer uma caixa de diálogo, clique em Sim para salvar o arquivo ao seu projeto.

Adicionando controles ligados a dados

Nesta etapa, você adicionar os controles ligados a dados para o DataRepeater.

Para adicionar controles ligados a dados

No Fontes de dados janela, selecione o nó de nível superior para o os clientes tabela.
Altere o tipo subjacente da tabela para detalhes , clicando em detalhes na lista drop-down no nó da tabela.
Selecione o os clientes nó da tabela e arraste-o para a região de modelo de item (a região superior) da DataRepeater de controle.

A BindingNavigator controle é adicionado ao formulário e o NorthwindDataSet, CustomersBindingSource, CustomersTableAdapter, TableAdapterManager, e CustomersBindingNavigator componentes são adicionados à bandeja de componentes.
Selecione todos os campos e seus rótulos associados e posicioná-los perto da borda esquerda da região de modelo de item.
Selecione os últimos cinco campos (região, CEP, país, telefônico, e Fax) e seus rótulos associados e movê-los para cima e à direita dos seis primeiros campos.
Selecione o modelo de item (a região superior do controle).
Na janela Properties, defina a tamanho propriedade para 427, 170.

Neste ponto, você tem um aplicativo de trabalho que irá exibir uma lista de repetição de clientes. Você pode pressionar F5 para executar o aplicativo, alterar os dados e adicionar ou excluir registros de clientes.

As próximas etapas opcionais, você aprenderá como personalizar o DataRepeater de controle.

Próximas etapas (opcionais)

Nesta parte da explicação passo a passo consiste em quatro tarefas opcionais:

Alterar a aparência da DataRepeater de controle.
Impedindo que os usuários adicionem ou exclusão de registros.
Adicionando o recurso de pesquisa para o DataRepeater de controle.
Adicionando uma tabela mestre e detalhadas para o DataRepeater de controle.

Alterar a aparência do controle DataRepeater

Nesta etapa opcional, você alterar o BackColor da DataRepeater o controle em tempo de design. Você também adicionar código para exibir linhas em cores alternadas e alterar um rótulo ForeColor condicionalmente.

Para alterar a aparência do controle

No Windows Forms Designer, selecione a região (inferior) principal da DataRepeater de controle.
Na janela Properties, defina a BackColor propriedade para branco.
Clique duas vezes o DataRepeater para abrir o Editor de código.
No Editor de código, além de eventos na lista suspensa, clique em DrawItem.

No DrawItem o manipulador de eventos, adicione o seguinte código para alternativo a BackColor:

' Alternate the back color.
If (e.DataRepeaterItem.ItemIndex Mod 2) <> 0 Then
    ' Apply the secondary back color.
    e.DataRepeaterItem.BackColor = Color.AliceBlue
Else
    ' Apply the default back color.
    e.DataRepeaterItem.BackColor = DataRepeater1.BackColor
End If

// Alternate the back color.
if ((e.DataRepeaterItem.ItemIndex % 2) != 0)
// Apply the secondary back color.
{
    e.DataRepeaterItem.BackColor = Color.AliceBlue;
}
else
{
    // Apply the default back color.
    e.DataRepeaterItem.BackColor = dataRepeater1.BackColor;
}

No DrawItem o manipulador de eventos, adicione o seguinte código para alterar o ForeColor de um rótulo de acordo com uma condição:

If e.DataRepeaterItem.Controls(RegionTextBox.Name).Text = "" Then
    e.DataRepeaterItem.Controls("RegionLabel").
     ForeColor = Color.Red
Else
    e.DataRepeaterItem.Controls("RegionLabel").
     ForeColor = Color.Black
End If

if (e.DataRepeaterItem.Controls[regionTextBox.Name].Text == "")
{
    e.DataRepeaterItem.Controls["regionLabel"].ForeColor = Color.Red;
}
else
{
    e.DataRepeaterItem.Controls["regionLabel"].ForeColor = Color.Black;
}

Pressione F5 para executar o aplicativo e ver as personalizações.

Impedindo que os usuários adicionando ou excluindo registros

Nesta etapa opcional, você adicionar código que impede que os usuários adicionem ou excluam registros de DataRepeater de controle.

Para impedir que usuários adicionar e excluir registros

No Windows Forms Designer, clique duas vezes no formulário para abrir o Editor de código.

Adicione o seguinte código para o Form_Load evento:

DataRepeater1.AllowUserToAddItems = False
DataRepeater1.AllowUserToDeleteItems = False
BindingNavigatorAddNewItem.Enabled = False
CustomersBindingSource.AllowNew = False
BindingNavigatorDeleteItem.Enabled = False

dataRepeater1.AllowUserToAddItems = false;
dataRepeater1.AllowUserToDeleteItems = false;
bindingNavigatorAddNewItem.Enabled = false;
customersBindingSource.AllowNew = false;
bindingNavigatorDeleteItem.Enabled = false;

Na lista suspensa Class Name, clique em BindingNavigatorDeleteItem. Na lista drop-down Method Name, clique em EnabledChanged.
Adicione o seguinte código para o manipulador de eventos BindingNavigatorDeleteItem_EnabledChanged:
```
If BindingNavigatorDeleteItem.Enabled = True Then
    BindingNavigatorDeleteItem.Enabled = False
End If
```
```
if (bindingNavigatorDeleteItem.Enabled == true)
{
    bindingNavigatorDeleteItem.Enabled = false;
}
```
Observação

Essa etapa é necessária porque a BindingSource permitirá que o DeleteItem botão toda vez que o registro atual é alterado.
Pressione F5 para executar o aplicativo. Observe que o DeleteItem botão está desativado e você não pode excluir itens pressionando a tecla DELETE.

Observação
Essa etapa é necessária porque a BindingSource permitirá que o DeleteItem botão toda vez que o registro atual é alterado.

Adicionando o recurso de pesquisa para o controle DataRepeater

Nesta etapa opcional, a capacidade de procurar um valor em implementar o DataRepeater de controle. Se a seqüência de pesquisa for encontrada, o controle seleciona o item que contém o valor e o item é movido para a exibição.

Para adicionar o recurso de pesquisa

Arrastar um TextBox de controle da Toolbox para o formulário que contém o DataRepeater de controle.

Posicione-o sob o DataRepeater de controle.
Na janela Properties, altere o nome propriedade para SearchTextBox.
Arrastar um Button de controle da Toolbox para o formulário que contém o DataRepeater de controle. Posicione-o sob o DataRepeater de controle.
Na janela Properties, altere o nome propriedade para SearchButton. Alterar o texto propriedade para pesquisa.

Clique duas vezes o Button de controle para abrir o Editor de código e, em seguida, adicione o seguinte código para o SearchButton_Click manipulador de eventos.

Dim foundIndex As Integer
Dim searchString As String
searchString = SearchTextBox.Text
' Search for the string in the CustomerID field.
foundIndex = CustomersBindingSource.Find("CustomerID",
 searchString)
If foundIndex > -1 Then
    DataRepeater1.CurrentItemIndex = foundIndex
Else
    MsgBox("Item " & searchString & " not found.")
End If

int foundIndex;
string searchString;
searchString = searchTextBox.Text;
// Search for the string in the CustomerID field.
foundIndex = customersBindingSource.Find("CustomerID", searchString);
if (foundIndex > -1)
{
    dataRepeater1.CurrentItemIndex = foundIndex;
}
else
{
    MessageBox.Show("Item " + searchString + " not found.");
}

Pressione F5 para executar o aplicativo. Digite uma ID de cliente em SearchTextBox e clique no pesquisa botão.

Adicionando um mestre e a tabela de detalhe à DataRepeater

Nesta etapa opcional, você adicionar um segundo DataRepeater o controle para exibir os pedidos relacionados para cada cliente.

Para adicionar uma tabela mestre e detalhadas

Arraste um segundo DataRepeater de controle da Visual Basic PowerPacks guia de Toolbox para o formulário.
Na janela Properties, defina a local propriedade para 465, 25.
Definir o tamanho propriedade para 315, 600.
No Fontes de dados janela, expanda o clientes nó da tabela e selecione o nó de detalhe para o pedidos tabela.
Altere o tipo subjacente esse pedidos tabela detalhes clicando em detalhes na lista drop-down no nó da tabela.
Arraste esta pedidos o nó de tabela para a região de modelo de item (a região superior) da segunda DataRepeater de controle.

Um OrdersBindingSource componente e um OrdersTableAdapter componentes são adicionados à bandeja de componentes.
Pressione F5 para executar o aplicativo. Quando você seleciona cada cliente no primeiro DataRepeater o controle, os pedidos desse cliente são exibidos na segunda DataRepeater de controle.