Wskazówki: wyświetlanie danych w formancie DataRepeater (Visual Studio)

Artykuł
06/10/2015

W tym instruktażu zapewnia podstawowy scenariusz rozpoczęcie zakończenie do wyświetlania dane powiązane w DataRepeater kontroli.

Warunkiem wstępnym

W tym instruktażu wymaga przykładowa baza danych Northwind.

Jeśli nie masz tej bazy danych na komputerze dewelopera, można pobrać ją z Centrum pobierania firmy Microsoft.Aby uzyskać instrukcje, zobacz Downloading Sample Databases.

Omówienie

Pierwsza część tego instruktażu składa się z czterech głównych zadań:

Tworzenie rozwiązania.
Dodawanie DataRepeater kontroli.
Dodawanie źródła danych.
Dodając formanty powiązane dane.

[!UWAGA]

Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Tworzenie rozwiązania DataRepeater

W pierwszym kroku tworzenia projektu i roztworu.

Aby utworzyć rozwiązanie DataRepeater

W Visual Studio pliku menu, kliknij przycisk Nowy projekt.
W typów projektów okienka w Nowy projekt okno dialogowe rozwiń języka Visual Basic, a następnie kliknij przycisk Windows.
W szablonów okienka, kliknij Aplikacji Windows Forms.
W Nazwa wpisz DataRepeaterApp.
Click OK.

Zostanie otwarty projektant Windows Forms.
Wybierz formularz w projektancie Windows Forms.W Właściwości okno, ustawić rozmiar właściwość, aby 800, 700.

Dodawanie formantu DataRepeater

W tym kroku należy dodać DataRepeater formantu do formularza.

Aby dodać formant DataRepeater

Na widoku menu, kliknij przycisk Przybornik.

Przybornik otwiera.
Wybierz PowerPacks programu Visual Basic kartę.
Przeciągnij DataRepeater kontroli na formularz Form1.
W oknie dialogowym właściwości ustaw lokalizację właściwość, aby 0, 25.
Ustaw rozmiar właściwość, aby 460, 600.

Dodawanie źródła danych

W tym kroku należy dodać źródło danych dla DataRepeater kontroli.

Aby dodać źródło danych

Na danych menu, kliknij przycisk Pokaż źródeł danych.
W Źródła danych okna, kliknij Dodać nowe źródło danych.
Wybierz bazy danych na Wybierz typ źródła danych stronę, a następnie kliknij przycisk Dalej.
Na Wybieranie połączenia danych strony, wykonaj jedną z następujących czynności:
- Jeśli połączenie danych z przykładowej bazy danych Northwind jest dostępna na liście rozwijanej, kliknij go.
  
  - lub -
- Kliknij przycisk Nowe połączenie do skonfigurowania nowego połączenia danych.Aby uzyskać więcej informacji, zobacz How to: Create Connections to SQL Server Databases.
Jeśli baza danych wymaga podania hasła, zaznacz opcję zawierają dane poufne, a następnie kliknij przycisk Dalej.

[!UWAGA]

Jeśli pojawi się okno dialogowe, kliknij Tak Aby zapisać plik projektu.
Kliknij przycisk Dalej na Zapisać ciąg połączenia w pliku konfiguracji aplikacji strony.
Rozwiń węzeł tabel węzeł na Wybierz obiekty bazy danych użytkownika strony.
Zaznacz pola wyboru obok Klienci i zamówienia tabel, a następnie kliknij przycisk Zakończenie.

NorthwindDataSet jest dodawany do projektu i Klienci i zamówienia tabele zostaną wyświetlone w Źródła danych okna.

Dodając formanty powiązane dane

W tym kroku można dodawać formanty powiązane z danymi do DataRepeater.

Aby dodać formanty powiązane z danymi

W Źródła danych okno, wybierz węzeł najwyższego poziomu dla Klienci tabeli.
Zmienianie typu drop tabeli, aby Szczegóły przez kliknięcie przycisku Szczegóły w węźle tabeli na liście rozwijanej.
Wybierz Klienci Tabela węzła i przeciągnij go na region (region górnej) szablonu elementu z DataRepeater kontroli.

A BindingNavigator formantu zostanie dodany do formularza, a NorthwindDataSet, CustomersBindingSource, CustomersTableAdapter, TableAdapterManager, i CustomersBindingNavigator składników są dodawane do komponentów.
Zaznacz wszystkie pola i ich skojarzone etykiety i umieść je przy lewej krawędzi elementu region szablonu.
Wybierz ostatnich pięciu pól (regionu, Kod pocztowy, kraju, Telefon, i Faks) i ich skojarzone etykiety i przenieść je w górę i na prawo od sześciu pierwszych pól.
Wybierz szablon elementu (górny region kontroli).
W oknie dialogowym właściwości ustaw rozmiar właściwość, aby 427, 170.

W tym momencie mieć aplikacji pracy, która będzie wyświetlać powtarzanej listy klientów.Można nacisnąć klawisz F5, aby uruchomić aplikację, zmień dane i dodawać lub usuwać rekordy klientów.

W następnych krokach opcjonalne, będą informacje o sposobach dostosować DataRepeater kontroli.

Kolejne kroki (opcjonalnie)

Ta część instruktaż składa się z czterech zadań opcjonalnych:

Zmiana wyglądu DataRepeater kontroli.
Uniemożliwia użytkownikom dodawanie lub usuwanie rekordów.
Dodanie możliwości wyszukiwania, aby DataRepeater kontroli.
Dodawanie tabeli wzorcowe i szczegółowe, aby DataRepeater kontroli.

Zmienianie wyglądu formantu DataRepeater

W ten opcjonalny krok, zmienić BackColor z DataRepeater kontroli w czasie projektowania.Można również dodać kod do wyświetlania wierszy w naprzemienne kolory i zmienić etykietę ForeColor warunkowo.

Aby zmienić wygląd formantu

W projektancie Windows Forms, zaznacz region głównych (niższa) DataRepeater kontroli.
W oknie dialogowym właściwości ustaw BackColor właściwość na biały.
Kliknij dwukrotnie DataRepeater , aby otworzyć Edytor kodu.
W edytorze kodu, w przypadku rozwijanej listy, kliknij DrawItem.

W DrawItem obsługi zdarzeń, Dodaj następujący kod do alternatywnego 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;
}

W DrawItem obsługi zdarzeń, Dodaj następujący kod do zmiany ForeColor etykiety w zależności od warunku:

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;
}

Naciśnij klawisz F5, aby uruchomić aplikację i zobacz dostosowań.

Uniemożliwia użytkownikom dodawanie lub usuwanie rekordów

W ten opcjonalny krok, należy dodać kod, który uniemożliwia użytkownikom dodawanie lub usuwanie rekordów w DataRepeater kontroli.

Aby uniemożliwić użytkownikom dodawanie i usuwanie rekordów

W projektancie Windows Forms kliknij dwukrotnie formularz, aby otworzyć Edytor kodu.

Dodaj następujący kod do Form_Load zdarzeń:

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 liście rozwijanej Nazwa klasy, kliknij przycisk BindingNavigatorDeleteItem.Na liście rozwijanej Nazwa metody kliknij EnabledChanged.
Dodaj następujący kod do BindingNavigatorDeleteItem_EnabledChanged programu obsługi zdarzeń:
```
If BindingNavigatorDeleteItem.Enabled = True Then
    BindingNavigatorDeleteItem.Enabled = False 
End If
```
```
if (bindingNavigatorDeleteItem.Enabled == true)
{
    bindingNavigatorDeleteItem.Enabled = false;
}
```
[!UWAGA]

Ten krok jest konieczny ponieważ BindingSource umożliwi DeleteItem przycisk każdym razem, gdy zmienia się rekordem bieżącym.
Naciśnij klawisz F5, aby uruchomić aplikację.Warto zauważyć, że DeleteItem przycisk jest wyłączony, i że nie można usunąć elementów przez naciśnięcie klawisza DELETE.

Dodanie możliwości wyszukiwania do formantu DataRepeater

W tym kroku opcjonalne zaimplementowaniem możliwości wyszukiwania wartości w DataRepeater kontroli.Jeśli zostanie znaleziony ciąg wyszukiwania, kontroli zaznacza element, który zawiera wartość i przewinięty elementu.

Aby dodać możliwości wyszukiwania

Przeciągnij TextBox kontroli z Przybornik na formularz, który zawiera DataRepeater kontroli.

Umieść go pod DataRepeater kontroli.
W oknie Właściwości zmień Nazwa właściwości SearchTextBox.
Przeciągnij Button kontroli z Przybornik na formularz, który zawiera DataRepeater kontroli.Umieść go pod DataRepeater kontroli.
W oknie Właściwości zmień Nazwa właściwości SearchButton.Zmiana tekst właściwości do wyszukiwania.

Kliknij dwukrotnie Button kontroli, aby otworzyć Edytor kodu, a następnie dodaj następujący kod do SearchButton_Click programu obsługi zdarzeń.

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.");
}

Naciśnij klawisz F5, aby uruchomić aplikację.Wpisz identyfikator klienta w SearchTextBox i kliknij przycisk wyszukiwania przycisku.

Dodawanie wzorca i szczegółów tabeli do DataRepeater

W tym kroku opcjonalne, można dodać drugi DataRepeater formantu, aby wyświetlić powiązane zamówienia dla każdego klienta.

Aby dodać tabelę wzorcowe i szczegółowe

Przeciągnij drugi DataRepeater kontroli z PowerPacks programu Visual Basic kartę w Przybornik na formularz.
W oknie dialogowym właściwości ustaw lokalizację właściwość, aby 465, 25.
Ustaw rozmiar właściwość, aby 315, 600.
W Źródła danych okna, rozwiń węzeł Klienci węzeł tabeli i wybierz węzeł szczegółów dla zamówienia tabeli.
Zmienianie typu drop zamówienia tabeli Szczegóły, klikając Szczegóły w węźle tabeli na liście rozwijanej.
Przeciągnij to zamówienia węzeł tabeli na region szablonu elementu (górnej) drugi DataRepeater kontroli.

OrdersBindingSource składnika i OrdersTableAdapter składnika są dodawane do komponentów.
Naciśnij klawisz F5, aby uruchomić aplikację.Po zaznaczeniu każdego klienta w pierwszym DataRepeater kontroli, zamówienia dla tego klienta są wyświetlane w drugim DataRepeater kontroli.