Názorný postup: Přidání ověření do objektu Dataset

Článek
03/04/2013

Názorný postup při ověření dat při změně dat v objektu dataset.Kde provést kontroly ověření dat je závislá na požadavky aplikace; pro tento návod jsme ověření dat během změny hodnot v jednotlivých sloupcích.Tento návod používá ColumnChanging událostí ověřte přijatelná hodnota se zadává do záznamu.Pokud hodnota není platný, ErrorProvider řízení se zobrazí uživateli.

Příklad také ukazuje, jak použít Dataset Návrhář vytvořit částečné třídy pro objekt dataset.(Částečné třídy je, kam mohou uživatelé přidávat kód k rozšíření funkcí Visual Studio–generated dataset.Je být přepsány, pokud je vygenerován nový objekt dataset.)

[!POZNÁMKA]

Ve vašem počítači se pro některé z prvků uživatelského rozhraní sady Visual Studio mohou zobrazit jiné názvy a umístění, než jsou uvedeny v následujících pokynech. Tyto prvky jsou určeny verzí aplikace Visual Studio a použitým nastavením. Další informace naleznete v tématu Nastavení aplikace Visual Studio.

Úlohy v tomto návodu zahrnují:

Vytvoření nového Aplikace systému Windows projektu.
Vytváření a konfigurace objektu dataset s Průvodce konfigurací zdroje dat.
Výběr ovládacího prvku ve formuláři vytvořit při přetahování položek z Zdroje dat okna.Další informace naleznete v tématu Jak: nastavení řízení má být vytvořen při přetažení z okno zdroje dat.
Vytvoření ovládací prvek vázán na data přetažením položek z Okno zdroje dat do formuláře.
Vytvoření dílčí třídy rozšíření funkcí objektu dataset.
Vytvoření obslužné rutiny události pro OrderDetails tabulky ColumnChanging událostí.
Přidání ověření potvrdit, že Quantity sloupec obsahuje hodnoty větší než 0.
Zobrazení Komponenta může zprostředkovatel ErrorProvider (model Windows Forms) informovat uživatele, že ovládací prvek vázán na data obsahuje neplatné hodnoty.

Požadavky

K dokončení tohoto návodu budete potřebovat:

Přístup k ukázkové databázi Northwind.Další informace naleznete v tématu Jak: Instalace ukázkové databáze.

Vytvoření nové aplikace systému Windows

Vytvořit nový projekt aplikace systému Windows

Z soubor nabídka, vytvoření nového projektu.
Název projektu ValidationWalkthrough.
Vyberte Aplikace systému Windows a na OK.Další informace naleznete v tématu Tvorba klientských aplikací.

ValidationWalkthrough projektu je vytvořena a přidána do Aplikaci Solution Explorer.

Vytvoření nového zdroje dat z databáze

Vytvořit zdroj dat

V nabídce Data klikněte na tlačítko Zobrazit zdroje dat.
V Zdroje dat vyberte Přidat nový zdroj dat spustit Průvodce konfigurací zdroje dat.
Vyberte Databázi na stránce Zvolit datový typ zdrojová databáze a potom klikněte na tlačítko Next.
Na Zvolte datové připojení stránky proveďte jeden z následujících:
- Pokud datové připojení k ukázkové databázi Northwind je k dispozici v rozevíracím seznamu, vyberte ji.
  
  -nebo-
- Vyberte Nové připojení spustit Přidat nebo změnit připojení dialogové okno.Další informace naleznete v tématu Přidat či upravte dialogové okno připojení (Obecné).
Pokud databáze vyžaduje heslo, vyberte možnost obsahují citlivá data a potom klepněte na tlačítko Další.
Klepněte na tlačítko Další na Uložit řetězec připojení v souboru konfigurace aplikace stránku.
Rozbalte tabulek uzel zvolit databázové objekty stránky.
Vyberte Podrobnosti objednávky tabulka a potom klepněte na tlačítko Dokončit.

NorthwindDataSet je do projektu a Rozpis objednávek tabulka Zdroje dat okno.

Vytváření ovládací prvky vázané na Data

Vytvořit data vázané ovládací prvky ve formuláři

V Zdroje dat vyberte Podrobnosti objednávky tabulky.
Zvolte Podrobnosti ze seznamu ovládacího prvku tabulky.
Přetáhněte Podrobnosti objednávky z uzlu Zdroje dat okna do Form1.

Ve formuláři spolu s pruh nástrojů se zobrazí ovládací prvky vázané na data s popisky (BindingNavigator) pro procházení záznamů.Ve formuláři spolu s pruh nástrojů se zobrazí ovládací prvky vázané na data s popisky (BindingNavigator) pro procházení záznamů.A NorthwindDataSet, Order_DetailsTableAdapter, BindingSource, a BindingNavigator se zobrazují na hlavním panelu komponenty.

Přidání do formuláře ovládací prvek může zprostředkovatel ErrorProvider

Konfigurace prvku může zprostředkovatel ErrorProvider

Přetáhněte ErrorProvider z nástrojů na Form1.
V Vlastnosti okno, nastavte ErrorProviderna DataSource vlastnosti Order_DetailsBindingSource.

[!POZNÁMKA]

Není nastavena DataMember vlastnost.

Vytvoření obslužné rutiny události ColumnChanging

Vytvoření obslužné rutiny události ověřování

Otevřete NorthwindDataSet v Dataset Návrhář poklepáním NorthwindDataSet.xsd soubor v aplikaci Solution Explorer.
Poklepejte Quantity sloupce v OrderDetails tabulky a vytvořit OrderDetailsDataTable_ColumnChanging obslužnou rutinu události.(V jazyce C# pouze částečné třídy dat tabulky bude vytvořen.)

[!POZNÁMKA]

Poklepáním na název tabulky (Podrobnosti objednávky v záhlaví) vytvoří obslužnou rutinu události pro RowChanging událostí.

Přidat kód ověřit, zda e.ProposedValue obsahuje hodnoty větší než 0.Pokud je navrhovaná hodnota 0 nebo méně, nastavte sloupec označte obsahuje chybu.

Vložte následující kód do sloupce změna obslužné rutiny níže uživatelského kódu přidat Poznámka:

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

Testování aplikace

Stisknutím klávesy F5 spustíte aplikaci.
Hodnotu můžete změnit množství textového pole na hodnotu 0.
Stisknutím klávesy TAB přesunete fokus z textového pole.

Zobrazí se ikona chyba zprostředkovatele.
Ukazatel myši přes zprostředkovatele chybovou zprávu.

Další kroky

V závislosti na požadavcích aplikace existuje několik kroků, které chcete provést po přidání ověření.Některá vylepšení, které nelze provést tento návod obsahuje:

Přidání funkce Odeslat aktualizace databáze.Další informace naleznete v tématu Názorný postup: Ukládání dat do databáze (jedna tabulka).
Úpravy objektu dataset přidat nebo odstranit objekty databáze.Další informace naleznete v tématu Jak: upravit objekt Dataset.