Instruktaż: Dodawanie sprawdzania poprawności do elementu Dataset

Artykuł
02/27/2013

W tym instruktażu przedstawiono sposób sprawdzania poprawności danych, gdy zostaną wprowadzone zmiany do danych w zestawie danych.Gdzie wykonać sprawdzanie poprawności na podstawie danych jest zależna od wymagań aplikacji; dla tego instruktażu możemy sprawdzania poprawności danych podczas zmiany wartości w poszczególnych kolumnach.W tym instruktażu wykorzystano ColumnChanging zdarzenie, aby zweryfikować, że dopuszczalna wartość jest wprowadzanego do rekordu.Jeśli wartość nie jest prawidłowa, ErrorProvider formantu jest wyświetlana użytkownikowi.

W przykładzie pokazano również jak używać Projektanta zestawów danych do tworzenia klas częściowego dla obiektu dataset.(Częściowej klasy jest, gdy użytkownicy mogą dodawać kod, aby rozszerzyć funkcjonalność Visual Studio–generated dataset."Jest on nie być zastępowane, jeżeli zestaw danych jest regenerowany.)

[!UWAGA]

Na danym komputerze mogą być używane inne nazwy lub lokalizacje pewnych elementów interfejsu użytkownika programu Visual Studio, które są używane w poniższych instrukcjach. Używana wersja programu Visual Studio oraz jej ustawienia określają te elementy. Aby uzyskać więcej informacji, zobacz Visual Studio, ustawienia.

W tym instruktażu zadania obejmują:

Tworzenie nowego Aplikacji Windows projektu.
Tworzenie i konfigurowanie dataset z Kreator konfiguracji źródła danych.
Zaznaczanie formantu aby utworzone w formularzu, podczas przeciągania elementów z Źródła danych okna.Aby uzyskać więcej informacji, zobacz Jak: formant ma zostać utworzony podczas przeciągania w oknie źródła danych.
Tworzenie formantu powiązanego z danymi, przeciągając elementy z Okno źródła danych do formularza.
Tworzenie klasy częściowe rozszerzać funkcjonalność obiektu dataset.
Tworzenie obsługi zdarzenia OrderDetails w tabeli ColumnChanging zdarzenia.
Dodawanie sprawdzania poprawności, aby potwierdzić, że Quantity kolumna zawiera wartooci większe niż 0.
Wyświetlanie Części projektowanego (Windows Forms) , aby poinformować użytkowników, że formant powiązany z danymi zawiera nieprawidłowe wartości.

Wymagania wstępne

W celu przeprowadzenia tego instruktażu są potrzebne:

Dostęp do bazy danych Northwind.Aby uzyskać więcej informacji, zobacz Jak: Instalowanie przykładowe bazy danych.

Tworzenie nowej aplikacji systemu Windows

Aby utworzyć nowy projekt aplikacji systemu Windows

Z pliku menu, tworzenie nowego projektu.
Nazwa projektu ValidationWalkthrough.
Wybierz Aplikacji Windows i kliknij przycisk OK.Aby uzyskać więcej informacji, zobacz Tworzenie aplikacji klienta.

ValidationWalkthrough projektu jest tworzony i dodawany do Solution Explorer.

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

Aby utworzyć źródło danych

Na danych menu, kliknij przycisk Pokaż źródeł danych.
W Źródła danych okno select Dodać nowe źródło danych uruchomić Kreatora konfiguracji źródła danych.
Wybierz bazy danych na Wybierz typ źródła danych stronę, a następnie kliknij przycisk Dalej.
Na Wybierz połączenie danych do strony, 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, należy go zaznaczyć.
  
  - lub -
- Wybierz Nowe połączenie uruchomić Dodawanie i modyfikowanie połączenia okno dialogowe.Aby uzyskać więcej informacji, zobacz Dodawanie/modyfikowanie połączeń, okno dialogowe (Ogólne).
Jeśli baza danych wymaga podania hasła, zaznacz opcję zawierają dane poufne, a następnie kliknij przycisk Dalej.
Kliknij przycisk Dalej na zapisać ciąg połączenia w pliku konfiguracyjnym aplikacji strony.
Rozwiń węzeł tabel węzeł na Wybierz obiekty bazy danych strony.
Wybierz Szczegóły zamówienia tabeli, a następnie kliknij przycisk Zakończenie.

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

Tworzenie formantów powiązanych danych

Aby utworzyć dane związany formantów formularza

W Źródła danych okno select Szczegóły zamówienia tabeli.
Wybierz Szczegóły z tabeli formant listy.
Przeciągnij Szczegóły zamówienia węzła z Źródła danych okna na formularz Form1.

Formanty powiązane z danymi z opisowe etykiety są wyświetlane w formularzu, wraz z pasek narzędzi (BindingNavigator) do nawigowania między rekordami.Formanty powiązane z danymi z opisowe etykiety są wyświetlane w formularzu, wraz z pasek narzędzi (BindingNavigator) do nawigowania między rekordami.A NorthwindDataSet, Order_DetailsTableAdapter, BindingSource, i BindingNavigator są wyświetlane w panelu komponentów.

Dodawanie formantu projektowanego w formularzu

Aby skonfigurować sterowanie projektowanego

Przeciągnij ErrorProvider z Przybornik na formularz Form1.
W Właściwości okno, ustawić ErrorProviderna DataSource właściwość, aby Order_DetailsBindingSource.

[!UWAGA]

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

Tworzenie procedury obsługi zdarzeń ColumnChanging

Aby utworzyć sprawdzanie poprawności procedury obsługi zdarzeń

Otwórz NorthwindDataSet w Projektant Dataset przez dwukrotne kliknięcie NorthwindDataSet.xsd plik w oknie Solution Explorer.
Kliknij dwukrotnie Quantity kolumny w OrderDetails tabeli, aby utworzyć OrderDetailsDataTable_ColumnChanging programu obsługi zdarzeń.(W języku C# tylko klasy częściowych tabeli danych zostanie utworzony.)

[!UWAGA]

Dwukrotne kliknięcie nazwy tabeli (Szczegóły zamówienia na pasku tytułu) tworzy moduł obsługi zdarzenia RowChanging zdarzenia.

Dodaj kod, aby zweryfikować, czy e.ProposedValue zawierają wartości większe od 0.Jeżeli proponowana wartość 0 lub mniej, należy ustawić kolumnę, aby wskazać, że zawiera ona błąd.

Wklej następujący kod do obsługi zdarzenia zmiany w kolumnie poniżej Kod użytkownika Dodaj 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 Ilość pola tekstowego na wartość 0.
Naciśnij klawisz TAB, aby przenieoć fokus z pola tekstowego.

Pojawi się ikona Błąd dostawcy.
Umieść wskaźnik myszy nad dostawcy błędu, aby zobaczyć komunikat.

Następne kroki

W zależności od wymagań aplikacji istnieje kilka czynności, które chcesz wykonać po dodaniu sprawdzania poprawności.Niektóre rozszerzenia, które mogłoby się przyczynić do tego instruktażu obejmują:

Dodawanie funkcji, aby wysyłać aktualizacje bazy danych.Aby uzyskać więcej informacji, zobacz Instruktaż: Zapisywanie danych do bazy danych (pojedynczej tabeli).
Edytowanie zestawu danych do dodawania lub usuwania obiektów bazy danych.Aby uzyskać więcej informacji, zobacz Jak: edytowanie zestawu danych.