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

Artigo
08/25/2010

Esta explicação passo a passo fornece um cenário básico de início-a-Concluir para a exibição limite dados em um DataRepeater controle.

Pré-requisito

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

Se você não tiver esse banco de dados no seu computador de desenvolvimento, você pode baixá-lo do centralizar de baixar 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 controle.
Adicionando uma fonte de dados.
Adicionando dados-limite controles.

Observação:
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de 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

A primeira etapa, você cria uma solução e projeto.

Para criar uma solução DataRepeater

Sobre o Visual Studio Arquivo menu, clicar Novo projeto.
No Tipos de projeto painel o Novo projeto diálogo caixa, expandir Visual Basice, em seguida, clicar Windows.
Clique em Windows Application no painel Templates.
No Nome box, type DataRepeaterApp.
Clique em OK.

O Designer de Formulários do Windows abre.
selecionar o formulário no Designer de Formulários do Windows.No Propriedades janela, conjunto o dimensionar propriedade 800, 700.

Adicionando um controle DataRepeater

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

Para adicionar um controle DataRepeater

No menu Exibir, clique em Caixa de Ferramentas.

A Toolbox abre.
selecionar o Visual Basic PowerPacks guia.
arrastar um DataRepeater controlar até Form1.
Na janela Propriedades, conjunto o Local propriedade 0, 25.
conjunto o dimensionar propriedade 460, 600.

Adicionando uma fonte de dados

Nesta etapa, você adicionar uma fonte de dados para o DataRepeater 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 escolher sua conexão de dados 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 -
- clicar Nova conexão para configurar uma nova conexão de dados.Para obter mais informações, consulte Como: Criar conexões para SQL Servidor bancos de dados.
Se o banco de dados exige uma senha, selecione a opção para incluir dados confidenciais, e clique Next.

Observação:

Se uma caixa de diálogo for exibida, clicar Sim para salvar o arquivo para seu projeto.
clicar Próximo on the Salvar cadeia 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 próxima à Clientes and Pedidos tabelas e, em seguida, clicar Concluir.

NorthwindDataSet é adicionado ao seu projeto e o Clientes and Pedidos tabelas aparecem no Fontes de dados janela.

Observação:
Se uma caixa de diálogo for exibida, clicar Sim para salvar o arquivo para seu projeto.

Adicionando dados-limite controles

Nesta etapa, você adicionar dados-limite controles para o DataRepeater.

Para adicionar controles ligados a dados

No Fontes de dados janela, selecionar o nó de nível superior a Clientes tabela.
Altere o drop type da tabela para Detalhes clicando em Detalhes na lista drop-down no nó da tabela.
selecionar o Clientes nó da tabela e arrastar-o para a região de modelo de item (a região superior) do DataRepeater controle.

A BindingNavigator controle é adicionado ao formulário e o NorthwindDataSet, CustomersBindingSource, CustomersTableAdapter, TableAdapterManager, and CustomersBindingNavigator componentes são adicionados ao bandeja de componentes.
Selecionar todos os campos e seus rótulos associados e posicione-os perto da borda esquerda da região de modelo de item.
selecionar os últimos cinco campos (Região, CEP, Country, Telefone, and Fax) e seus rótulos associados e mova-os até e para a direita os seis primeiros campos.
selecionar o modelo de item (a região superior do controle).
Na janela Propriedades, defina o dimensionar propriedade 427, 170.

Neste ponto, você tiver 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 controle.

Próximas etapas (opcionais)

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

Alterar a aparência do DataRepeater controle.
Impedindo que os usuários adicionem ou excluam registros.
Adição da funcionalidade de Pesquisar para o DataRepeater controle.
Adicionar uma tabela mestre e detalhadas para o DataRepeater controle.

Alterando a aparência do controle DataRepeater

Essa etapa opcional, você alterar o BackColor da DataRepeater controle em time de design. Você também adicionar código para exibir as linhas alternando as cores e para alterar ForeColor condicionalmente.

Para alterar a aparência do controle

No Designer de Formulários do Windows, selecionar a região principal (inferior) do DataRepeater controle.
Na janela Propriedades, defina o BackColor propriedade em branco.
clicar duas vezes o DataRepeater Para em em aberto o Editor de código.
No Code Editor, no evento na lista suspensa, clicar DrawItem.

No DrawItem 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 evento manipulador, adicione o código a seguir 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 veja as personalizações.

Impedindo usuários de adicionando ou excluindo registros

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

Para impedir que os usuários adicionar e excluir registros

No Designer de Formulários do Windows, clicar duas vezes no formulário para em em aberto o Editor de código.

Adicione o seguinte código à 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 classe nome, clicar BindingNavigatorDeleteItem.Na lista suspensa método nome, clicar 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 o BindingSource permite que o DeleteItem botão toda vez que o registro corrente é alterado.
Pressione F5 para executar o aplicativo.Observe que o DeleteItem botão é desabilitado e não é possível excluir itens pressionando a tecla DELETE.

Observação:
Essa etapa é necessária porque o BindingSource permite que o DeleteItem botão toda vez que o registro corrente é alterado.

Adicionando capacidade de pesquisar o controle DataRepeater

Nesta etapa opcional, você implementa a capacidade de procurar um valor no DataRepeater controle. Se a seqüência de caracteres de Pesquisar for encontrada, o controle seleciona o item que contém o valor e rola o item para o modo de exibição.

Para adicionar o recurso de Pesquisar

arrastar um TextBox controlar a partir do Caixa de ferramentas para o formulário que contém o DataRepeater controle.

Posicione-a sob a DataRepeater controle.
Na janela Propriedades, alterar o Nomepropriedade para SearchTextBox.
arrastar um Button controlar a partir do Caixa de ferramentas para o formulário que contém o DataRepeater controle. Posicione-a sob a DataRepeater controle.
Na janela Propriedades, alterar o Nomepropriedade para SearchButton.Alterar o Texto propriedade Pesquisar.

clicar duas vezes o Button o controle para em em aberto o Editor de código e adicione o código a seguir 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 um código de cliente na SearchTextBox e clicar no Pesquisar botão.

Adicionando um mestre e tabela de detalhe para DataRepeater

Essa etapa opcional, você adicionar um segundo DataRepeater controle para exibir pedidos relacionados a cada cliente.

Para adicionar uma tabela mestre e detalhadas

arrastar um segundo DataRepeater controlar a partir do Visual Basic PowerPacks guia o Caixa de ferramentas para o formulário.
Na janela Propriedades, conjunto o Local propriedade 465, 25.
conjunto o dimensionar propriedade 315, 600.
No Fontes de dados janela, expandir o Clientes nó da tabela e selecionar o nó de detalhe para o Pedidos tabela.
Altere o tipo subjacente deste Pedidos tabela para Details clicando em Detalhes na lista drop-down no nó da tabela.
arrastar este Pedidos nó da tabela para a área de modelo de item (a região superior) do segundo DataRepeater controle.

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