Návod: Přidávání ověření do datové sady

Článek
06/14/2015

Tento průvodce ukazuje, jak ověřit data při změně data v datové sadě.Pokud provádíte ověřovací kontroly na data je závislá na požadavky na aplikace; v tomto návodu jsme ověřit data během změny hodnot v jednotlivých sloupců.V tomto návodu se používá ColumnChanging událostí, chcete-li ověřit, zda se přijatelná hodnota zadává do záznamu.Pokud hodnota není platná, ErrorProvider ovládací prvek je zobrazen uživateli.

V příkladu také ukazuje, jak používat datová sada Designer Chcete-li vytvořit dílčí třídu pro datovou sadu.(Částečné třída je, kde mohou uživatelé přidávat kód, který má rozšířit funkce Visual Studio– generované datové sady.Nesmí být přepsána Pokud datová sada dojde k novému generování.)

[!POZNÁMKA]

Na vašem počítači se můžou v následujících pokynech zobrazovat jiné názvy nebo umístění některých prvků uživatelského rozhraní Visual Studia. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace najdete v tématu Přizpůsobení nastavení pro vývoj v sadě Visual Studio.

Úlohy v tomto návodu zahrnují:

Vytvoření nového projektu aplikace systému Windows.
Vytváření a konfigurace na sadu dat s Průvodce konfigurací zdroje dat.
Výběr má být vytvořen ve formuláři při přetahování položek z ovládacího prvku zdroje dat okna.Další informace naleznete v tématu Postupy: Nastavení ovládacího prvku, který má být vytvořen při přetažení z okna zdrojů dat.
Vytvoření ovládacího prvku vázaného na data přetažením položek z Okno zdroje dat do formuláře.
Vytvoření částečné třídy pro rozšíření funkcí datová sada.
Vytvoření obslužné rutiny události pro OrderDetails tabulky ColumnChanging události.
Přidání ověřování potvrdit, že Quantity sloupec obsahuje hodnoty, které jsou větší než 0.
Zobrazení ErrorProvider – komponenta (Windows Forms) k informovat uživatele o tom, zda ovládací prvek vázaného 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 Postupy: Instalace ukázkových databází.

Vytvoření nové aplikace systému Windows

Vytvoření nového projektu aplikace pro systém Windows

Z soubor nabídky, vytvořte nový projekt.
Název projektu ValidationWalkthrough.
Vyberte aplikace pro systém Windows a klikněte na tlačítko OK.Další informace naleznete v tématu Vývoj klientských aplikací s použitím rozhraní .NET Framework.

ValidationWalkthrough je vytvořen a přidán do projektu Průzkumníka řešení.

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

Vytvoření zdroje dat

V nabídce Data klikněte na tlačítko Zobrazit zdroje dat.
V okně Zdroje dat výběrem možnosti Přidat nový zdroj dat spusťte Průvodce konfigurací zdroje dat.
Vyberte možnost Databáze na stránce Zvolit typ datového zdroje a potom klikněte na tlačítko Další.
Na Vybrat datové připojení proveďte stránky, jeden z následujících akcí:
- Pokud je k dispozici v rozevíracím seznamu datové připojení k databázi Northwind ukázky, vyberte jej.
  
  -nebo-
- Vyberte Nové připojení k zobrazení dialogového okna Přidat nebo upravit připojení.
Pokud vaše databáze vyžaduje heslo, vyberte možnost k zahrnutí důvěrných osobních údajů a pak klikněte na tlačítko Další.
Klepněte na tlačítko Next na stránce Uložit připojovací řetězec do konfiguračního souboru aplikace.
Rozbalte uzel Tabulky na stránce Zvolte vaše databázové objekty.
Vyberte údaje v objednávce tabulky a potom klikněte na tlačítko Dokončit.

NorthwindDataSet je přidán do projektu a Rozpis objednávek tabulky se zobrazí v zdroje dat okna.

Vytváření ovládacích prvků vázaných na Data

Chcete-li vytvořit data vázané ovládací prvky ve formuláři

V zdroje dat okna, vyberte možnost údaje v objednávce tabulky.
Zvolte Podrobnosti ze seznamu ovládací prvek v tabulce.
Přetáhněte údaje v objednávce uzlu z zdroje dat okna do Form1.

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

Přidání ovládací prvek ErrorProvider – do formuláře

Chcete-li nakonfigurovat ovládací prvek ErrorProvider –

Přetáhněte ErrorProvider z nástrojů do Form1.
V Vlastnosti okně, nastavte ErrorProviderna DataSource vlastnost, která má Order_DetailsBindingSource.

[!POZNÁMKA]

Není nastavena DataMember vlastnost.

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

Chcete-li vytvořit ověření obslužných rutin událostí.

Otevřete NorthwindDataSet v datová sada Designer dvakrát kliknete NorthwindDataSet.xsd soubor v Průzkumníku řešení.
Klikněte dvakrát Quantity sloupec v OrderDetails tabulky a vytvořit OrderDetailsDataTable_ColumnChanging obslužnou rutinu události.(V jazyce C# pouze dílčí třídy tabulku dat bude vytvořen.)

[!POZNÁMKA]

Dvakrát klikněte na název tabulky (údaje v objednávce v záhlaví) vytvoří obslužnou rutinu pro RowChanging události.

Přidání kódu a ověřte, zda e.ProposedValue obsahuje hodnoty, které jsou větší než 0.Pokud navržená hodnota je 0 nebo méně, nastavte sloupec označuje, že obsahuje chybu.

Vložte následující kód do sloupce změna obslužná rutina události níže přidejte uživatele kód zde komentář:

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 ke spuštění aplikace.
Změňte hodnotu v poli množství textové pole na hodnotu 0.
Stisknutím klávesy TAB fokus přesunout z textového pole.

Zobrazí se ikona chyby zprostředkovatele.
Umístěním ukazatele myši na zprostředkovatele chybové Chcete-li zobrazit zprávu.

Další kroky

V závislosti na požadavcích aplikace existuje několik kroků, které chcete provádět po přidání ověření.Mezi vylepšení, která je možné pro tento návod provést, patří:

Přidání funkce k odesílání aktualizací zpět do databáze.Další informace naleznete v tématu Návod: Ukládání dat do databáze (jediná tabulka).
Úpravy sady dat můžete přidat nebo odebrat databázové objekty.Další informace naleznete v tématu Postupy: Upravování datové sady.