Navegar pelos dados

A maneira mais fácil de navegar pelos registros em uma fonte de dados é vincular um componente BindingSource à fonte de dados e, em seguida, vincular controles ao BindingSource. Em seguida, você pode usar o método de navegação interno do BindingSource, como MoveNext, MoveLast, MovePreviouse MoveFirst. O uso desses métodos ajustará as propriedades Position e Current do BindingSource apropriadamente. Você também pode encontrar um registro e defini-lo como o registro atual definindo a propriedade Position.

Para incrementar a posição do registro em uma fonte de dados

Defina a propriedade Position do BindingSource dos dados acoplados para definir a posição de registro necessária. O exemplo a seguir ilustra o uso do método MoveNext do BindingSource para incrementar a propriedade Position quando você seleciona o nextButton. O BindingSource está associado à tabela Customers de um conjunto de dados Northwind.

private void nextButton_Click(object sender, System.EventArgs e)
{
    this.customersBindingSource.MoveNext();
}

Private Sub nextButton_Click(ByVal sender As Object,
    ByVal e As System.EventArgs) Handles nextButton.Click
    Me.customersBindingSource.MoveNext()
End Sub

Para verificar se excedeu o primeiro ou o último registo

Crie um manipulador de eventos para o evento PositionChanged. No manipulador, você pode testar se o valor da posição proposta excedeu a contagem real de elementos de dados.

O exemplo a seguir ilustra como você pode testar se atingiu o último elemento de dados. No exemplo, se você estiver no último elemento, o botão Avançar no formulário será desabilitado.

void customersBindingSource_PositionChanged(object sender, EventArgs e)
{
    if (customersBindingSource.Position == customersBindingSource.Count - 1)
        nextButton.Enabled = false;
    else
        nextButton.Enabled = true;
}

Sub customersBindingSource_PositionChanged(ByVal sender As Object,
    ByVal e As EventArgs)

    If customersBindingSource.Position =
        customersBindingSource.Count - 1 Then
        nextButton.Enabled = False
    Else
        nextButton.Enabled = True
    End If
End Sub

Para localizar um registro e defini-lo como o item atual

Encontre o registro que você deseja definir como o item atual. Use o método Find do BindingSource como mostrado no exemplo, caso a sua fonte de dados implemente IBindingList. Alguns exemplos de fontes de dados que implementam IBindingList são BindingList<T> e DataView.

void findButton_Click(object sender, EventArgs e)
{
    int foundIndex = customersBindingSource.Find("CustomerID", "ANTON");
    customersBindingSource.Position = foundIndex;
}

Sub findButton_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles findButton.Click
    Dim foundIndex As Integer = customersBindingSource.Find("CustomerID",
        "ANTON")
    customersBindingSource.Position = foundIndex
End Sub

Para garantir que a linha selecionada em uma tabela filha permaneça na posição correta

Ao trabalhar com vinculação de dados no Windows Forms, você exibirá dados em um modo de exibição pai/filho ou mestre/detalhe. É um cenário de vinculação de dados em que os dados da mesma fonte são exibidos em dois controles. Alterar a seleção em um controle faz com que os dados exibidos no segundo controle sejam alterados. Por exemplo, o primeiro controle pode conter uma lista de clientes e o segundo uma lista de pedidos relacionados ao cliente selecionado no primeiro controle.

Quando se exibem dados num modo de visualização progenitor/descendente, poderá ser necessário tomar medidas adicionais para garantir que a linha selecionada atualmente na tabela descendente não seja redefinida para a primeira linha da tabela. Para fazer isso, você terá que armazenar em cache a posição da tabela filho e redefini-la depois que a tabela pai for alterada. Normalmente, a redefinição da tabela filha ocorre na primeira vez que um campo numa linha da tabela pai é alterado.

Para armazenar em cache a posição atual da tabela filha

1. Declare uma variável inteira para armazenar a posição da tabela filho e uma variável booleana para indicar se deve armazenar em cache a posição da tabela filho.

   private int cachedPosition = -1;
   private bool cacheChildPosition = true;
   

   Private cachedPosition As Integer = -1
   Private cacheChildPosition As Boolean = True
   

2. Manipule o evento ListChanged para o CurrencyManager da ligação e verifique se há um ListChangedType de Reset.

3. Verifique a posição atual do CurrencyManager. Se for maior do que a primeira entrada na lista (normalmente 0), salve-a em uma variável.

   void relatedCM_ListChanged(object sender, ListChangedEventArgs e)
   {
       // Check to see if this is a caching situation.
       if (cacheChildPosition && cachePositionCheckBox.Checked)
       {
           // If so, check to see if it is a reset situation, and the current
           // position is greater than zero.
           CurrencyManager relatedCM = sender as CurrencyManager;
           if (e.ListChangedType == ListChangedType.Reset && relatedCM.Position > 0)
   
               // If so, cache the position of the child table.
               cachedPosition = relatedCM.Position;
       }
   }
   

   Private Sub relatedCM_ListChanged(ByVal sender As Object,
       ByVal e As ListChangedEventArgs)
       ' Check to see if this is a caching situation.
       If cacheChildPosition AndAlso cachePositionCheckBox.Checked Then
           ' If so, check to see if it is a reset situation, and the current
           ' position is greater than zero.
           Dim relatedCM As CurrencyManager = sender
           If e.ListChangedType = ListChangedType.Reset _
               AndAlso relatedCM.Position > 0 Then
   
               ' If so, cache the position of the child table.
               cachedPosition = relatedCM.Position
           End If
       End If
   
   End Sub
   

4. Trate o evento CurrentChanged da lista superior para o gestor de moeda superior. No manipulador, defina o valor Boolean para indicar que não é um cenário de cache. Se o CurrentChanged ocorrer, a alteração relacionada com o pai é uma mudança de posição na lista e não uma alteração no valor do item.

   void bindingSource1_CurrentChanged(object sender, EventArgs e)
   {
       // If the CurrentChanged event occurs, this is not a caching
       // situation.
       cacheChildPosition = false;
   }
   

   ' Handle the current changed event. This event occurs when
   ' the current item is changed, but not when a field of the current
   ' item is changed.
   Private Sub bindingSource1_CurrentChanged(ByVal sender As Object,
       ByVal e As EventArgs) Handles bindingSource1.CurrentChanged
       ' If the CurrentChanged event occurs, this is not a caching 
       ' situation.
       cacheChildPosition = False
   
   End Sub
   

Para redefinir a posição da tabela filha

1. Manipule o evento PositionChanged para a ligação da tabela filho CurrencyManager.

2. Redefina a posição da tabela filha para a posição em cache guardada no procedimento anterior.

   void relatedCM_PositionChanged(object sender, EventArgs e)
   {
       // Check to see if this is a caching situation.
       if (cacheChildPosition && cachePositionCheckBox.Checked)
       {
           CurrencyManager relatedCM = sender as CurrencyManager;
   
           // If so, check to see if the current position is
           // not equal to the cached position and the cached
           // position is not out of bounds.
           if (relatedCM.Position != cachedPosition && cachedPosition
               > 0 && cachedPosition < relatedCM.Count)
           {
               relatedCM.Position = cachedPosition;
               cachedPosition = -1;
           }
       }
   }
   

   Private Sub relatedCM_PositionChanged(ByVal sender As Object, ByVal e As EventArgs)
       ' Check to see if this is a caching situation.
       If cacheChildPosition AndAlso cachePositionCheckBox.Checked Then
           Dim relatedCM As CurrencyManager = sender
   
           ' If so, check to see if the current position is 
           ' not equal to the cached position and the cached 
           ' position is not out of bounds.
           If relatedCM.Position <> cachedPosition AndAlso
               cachedPosition > 0 AndAlso cachedPosition <
               relatedCM.Count Then
               relatedCM.Position = cachedPosition
               cachedPosition = -1
           End If
       End If
   End Sub
   

Para testar o exemplo de código, execute as seguintes etapas:

1. Execute o exemplo.

2. Verifique se a caixa de seleção “Cache” e “redefinir posição” está marcada.

3. Selecione o botão Limpar campo pai para provocar uma alteração num campo na tabela pai. Observe que a linha selecionada na tabela filho não é alterada.

4. Feche e execute novamente o exemplo. Você precisa executá-lo novamente porque o comportamento de redefinição ocorre apenas na primeira alteração na linha parental.

5. Limpe a caixa de seleção Cache e redefina a posição.

6. Selecione o botão Limpar campo pai. Observe que a linha selecionada na tabela filha passa a ser a primeira linha.

Ver também

• Visão geral da vinculação de dados
• Fontes de dados suportadas pelo Windows Forms
• Notificação de Alteração na Vinculação de Dados do Windows Forms
• Como sincronizar vários controles com a mesma fonte de dados
• Componente BindingSource