Wskazówki: dodawanie sprawdzania poprawności do zestawu danych

Artykuł
06/10/2015

Niniejszy przewodnik pokazuje, jak sprawdzanie poprawności danych po wprowadzeniu zmian do danych w zestawie danych.Gdzie wykonać sprawdzanie poprawności danych w jest zależna od wymagania dotyczące aplikacji; dla tej procedury możemy sprawdzania poprawności danych podczas zmiany wartości w poszczególnych kolumnach.Niniejszy przewodnik używa ColumnChanging zdarzenie, aby sprawdzić, czy jest on wprowadzone dopuszczalną wartością do rekordu.Jeśli wartość jest nieprawidłowa, ErrorProvider formant jest wyświetlany dla użytkownika.

W przykładzie przedstawiono również sposób użycia Designer zestawu danych do utworzenia częściowego klasę dla zestawu danych.(Częściowej klasy jest, gdzie użytkownicy mogą dodawać kod, aby rozszerzyć funkcjonalność Visual Studio— wygenerowane zestawu danych.Jest nie zostać zastąpiony w przypadku ponownego wygenerowania zestaw danych).

[!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.

Zadania zilustrowane w tym przewodniku obejmują:

Tworzenie nowego projektu aplikacji systemu Windows.
Tworzenie i konfigurowanie zestawu danych z Kreator konfiguracji źródła danych.
Wybieranie formant, który ma zostać utworzony w formularzu, gdy przeciągając elementy z źródła danych okna.Aby uzyskać więcej informacji, zobacz Porady: ustawianie formantu do utworzenia podczas przeciągania z okna źródła danych.
Tworzenie kontrolkę powiązanej danymi, przeciągając elementy z Okno źródła danych do formularza.
Tworzenie częściowej klasy, aby rozszerzyć funkcjonalność zestawu danych.
Program obsługi zdarzeń dla tworzenia OrderDetails tabeli ColumnChanging zdarzenia.
Dodawanie sprawdzania poprawności, aby upewnić się, że Quantity Kolumna zawiera wartości większe od 0.
Wyświetlanie ErrorProvider — Składnik (Formularze systemu Windows) w celu poinformowania użytkowników, że formant powiązany z danymi zawiera nieprawidłowe wartości.

Wymagania wstępne

W celu wykonania instrukcji tego przewodnika są potrzebne:

Dostęp do przykładowej bazy danych Northwind.Aby uzyskać więcej informacji, zobacz Porady: instalacja przykładowych baz danych.

Tworzenie nowej aplikacji dla systemu Windows

Aby utworzyć nowy projekt aplikacji systemu Windows

Z pliku menu, Utwórz nowy projekt.
Nadaj nazwę projektowi ValidationWalkthrough.
Wybierz aplikacji systemu Windows i kliknij przycisk OK.Aby uzyskać więcej informacji, zobacz Wdrażanie aplikacji klienta za pomocą programu .NET Framework.

ValidationWalkthrough projektu zostało utworzone i dodane do Eksploratora rozwiązań.

Tworzenie nowego źródła danych z bazy danych

Aby utworzyć źródło danych

W menu Dane kliknij przycisk Pokaż źródła danych.
W oknie Źródła danych wybierz Dodaj nowe źródło danych aby uruchomić Kreatora konfiguracji źródła danych.
Wybierz Baza danych na stronie Wybierz typ źródła danych, a następnie kliknij Dalej.
Na Wybierz połączenie danych do strony, jedną z następujących czynności:
- Jeśli połączenie danych z bazie danych Northwind jest dostępna na liście rozwijanej, zaznacz go.
  
  —lub—
- Wybierz pozycję Nowe połączenie, aby otworzyć okno dialogowe Dodawanie/modyfikowanie połączenia.
Jeśli baza danych wymaga hasła, wybierz opcję dołączenia danych poufnych, a następnie kliknij przycisk Dalej.
Na stronie Zapisz ciąg połączeń do pliku konfiguracyjnego aplikacji kliknij Dalej.
Rozwiń węzeł Tabele na stronie Wybierz obiekty bazy danych.
Wybierz informacji tabeli, a następnie kliknij przycisk Zakończ.

NorthwindDataSet jest dodawany do projektu i SzczegółyZamówienia tabela pojawi się w źródła danych okna.

Tworzenie formantów powiązanych z danymi

Tworzenie danych powiązanych formantów formularza

W źródła danych wybierz informacji tabeli.
Wybierz Szczegóły z listy kontroli tabeli.
Przeciągnij informacji węzła z źródła danych okna na Form1.

Formanty powiązane dane z opisowe etykiety są widoczne w formularzu, wraz z pasek narzędzi (BindingNavigator) do nawigowania rekordów.Formanty powiązane dane z opisowe etykiety są widoczne w formularzu, wraz z pasek narzędzi (BindingNavigator) do nawigowania rekordów.Element NorthwindDataSet, Order_DetailsTableAdapter, BindingSource, i BindingNavigator są widoczne na pasku składnika.

Dodawanie do formularza formantu Dostawca błędów

Aby skonfigurować kontrolkę Dostawca błędów

Przeciągnij ErrorProvider z Przybornika na Form1.
W właściwości okna, ustaw ErrorProviderfirmy DataSource Właściwość do Order_DetailsBindingSource.

[!UWAGA]

Nie należy ustawiać DataMember Właściwości.

Tworzenie obsługi zdarzeń ColumnChanging

Aby utworzyć weryfikacji obsługi zdarzeń

Otwórz NorthwindDataSet w Designer zestawu danych klikając dwukrotnie NorthwindDataSet.xsd plików w Eksploratorze rozwiązań.
Kliknij dwukrotnie Quantity kolumny w OrderDetails tabeli, aby utworzyć OrderDetailsDataTable_ColumnChanging program obsługi zdarzeń.(W języku C# będzie można utworzyć tylko w tabeli danych częściowej klasy).

[!UWAGA]

Dwukrotne kliknięcie nazwy tabeli (informacji na pasku tytułu) tworzy program obsługi zdarzeń dla RowChanging zdarzenia.

Dodaj kod, aby sprawdzić, czy e.ProposedValue zawiera wartości większe od 0.Jeśli wartość proponowana jest mniejsze lub równe 0, należy ustawić kolumny, aby wskazać, że zawiera błąd.

Wklej następujący kod do obsługi zdarzeń zmiana kolumny poniżej tutaj należy dodać użytkownika kod komentarz:

If CType(e.ProposedValue, Short) <= 0 Then
        e.Row.SetColumnError(e.Column, "Quantity must be greater than 0")
    Else
        e.Row.SetColumnError(e.Column, "")
End If

// C#
// Add the following code 
// to the partial class.
    public override void EndInit()
    {
        base.EndInit();
        Order_DetailsRowChanging += TestRowChangeEvent;
    }

    public void TestRowChangeEvent(object sender, Order_DetailsRowChangeEvent e)
    {
        if ((short)e.Row.Quantity <= 0)
        {
            e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
        }
        else
        {
            e.Row.SetColumnError("Quantity", "");
        }
    }

Testowanie aplikacji

Aby przetestować aplikację

Naciśnij klawisz F5, aby uruchomić aplikację.
Zmień wartość w polu Ilość pola tekstowego na 0.
Naciśnij klawisz TAB, aby przenieść fokus poza pole tekstowe.

Jest wyświetlana ikona dostawcy błędu.
Wskaźnik myszy nad dostawcy błędów, aby zobaczyć komunikat.

Następne kroki

W zależności od potrzeb aplikacji istnieje kilka kroków, które można wykonać po dodaniu weryfikacji.Niektóre udoskonalenia, których można dokonać w tym instruktażu obejmują:

Dodawanie funkcji do odesłania aktualizacje do bazy danych.Aby uzyskać więcej informacji, zobacz Wskazówki: zapisywanie danych w bazie danych (Single Table).
Edytowanie zestawu danych, aby dodać lub usunąć obiektów bazy danych.Aby uzyskać więcej informacji, zobacz Porady: edytowanie zestawu danych.