Návod: Přidávání ověření do datové sady
Tento návod ukazuje, jak ověřit data provedení změn dat v datové sadě. Kde provést ověření dat je závislá na požadavcích aplikace; v tomto návodu jsme ověření dat během změny hodnoty v jednotlivých sloupcích. Tento návod používá ColumnChanging Chcete-li ověřit, že je přijatelná hodnota zadávány do záznamu událostí. Pokud hodnota není platná, ErrorProvider uživateli se zobrazí ovládací prvek.
Příklad také ukazuje, jak použít návrháře Dataset Chcete-li vytvořit dílčí třídu pro datovou sadu. (Částečné třídy je, kam mohou uživatelé přidávat kód pro rozšíření funkcí Visual Studio– generování datové sady. Je nebudou přepsány Pokud dataset je vygenerován nový.)
Poznámka
Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace najdete v tématu Customizing Development Settings in Visual Studio.
Úlohy v tomto návodu zahrnují:
Vytvoření nového projektu aplikace systému Windows.
Vytváření a konfigurace dataset s Průvodce konfigurací zdroje dat.
Ovládací prvek, který má být vytvořen ve formuláři při přetažení položek z výběru zdroje dat okno. 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ého kódu třídy pro rozšíření funkce objektu DataSet.
Vytvoření obslužné rutiny události OrderDetails tabulky ColumnChanging událostí.
Přidání ověření potvrdit, že Quantity sloupec obsahuje hodnotu větší než 0.
Zobrazení ErrorProvider – komponenta (Windows Forms) informovat uživatele, že vázaný ovládací prvek obsahuje neplatnou hodnotu.
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
Pomocí nabídky Soubor vytvořte nový projekt.
Název projektu ValidationWalkthrough.
Vyberte aplikace pro systém Windows a klepně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ík řešení.
Vytvoření nového zdroje dat z databáze
Vytvoření zdroje dat
V nabídce Data klikněte na položku 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 Vybrat typ zdroje dat a potom klikněte na tlačítko Další.
Na stránce Vybrat datové připojení proveďte jeden z následujících kroků:
Pokud je připojení dat k ukázkové databázi Northwind k dispozici v rozevíracím seznamu, vyberte je.
-nebo-
Vybráním možnosti Nové připojení zobrazte dialogové okno Přidat nebo upravit připojení.
Pokud vaše databáze vyžaduje heslo, vyberte možnost 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 podrobnosti objednávky tabulka a potom klepněte na tlačítko Dokončit.
NorthwindDataSet je přidán do projektu a Rozpis objednávek tabulka se objeví u zdroje dat okno.
Vytváření ovládacích prvků vázaných na Data
Chcete-li vytvořit data vázané ovládací prvky na 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.
Ovládací prvky vázané na data s popisky se zobrazí ve formuláři spolu s pruh nástrojů (BindingNavigator) pro procházení záznamů. Ovládací prvky vázané na data s popisky se zobrazí ve formuláři spolu s pruh nástrojů (BindingNavigator) pro procházení záznamů. A NorthwindDataSet, Order_DetailsTableAdapter, BindingSource, and BindingNavigator appear in the component tray.
Přidání ovládacího prvku ErrorProvider – do formuláře
Chcete-li nakonfigurovat ovládací prvek ErrorProvider –
Přetáhněte ErrorProvider z nástrojů na Form1.
In the Properties window, set the ErrorProvider's DataSource property to the Order_DetailsBindingSource.
Poznámka
Nenastavujte DataMember vlastnost.
Vytvoření obslužné rutiny události ColumnChanging
Vytvoření obslužné rutiny události ověřování
Otevřete NorthwindDataSet v návrháře Dataset poklepáním NorthwindDataSet.xsd soubor v Průzkumníku řešení.
Poklepejte Quantity ve sloupci OrderDetails tabulky a vytvořit OrderDetailsDataTable_ColumnChanging obslužnou rutinu události. (V jazyce C# pouze částečná třída tabulky dat bude vytvořena.)
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řidejte kód pro ověření e.ProposedValue obsahuje hodnotu větší než 0. Pokud navrhovaná hodnota 0 nebo menší, nastavte sloupec označíte, že obsahuje chybu.
Vložte následující kód do sloupce změnit obslužnou rutinu události níže přidat uživatelský 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
Testování aplikace
Stisknutím klávesy F5 spuštění aplikace.
Změňte hodnotu v poli množství textového pole na hodnotu 0.
Stisknutím klávesy TAB přesunete fokus z textového pole.
Zobrazí se ikona chyby zprostředkovatele.
Umístěním ukazatele myši na zprostředkovatele chybovou zprávu.
Další kroky
V závislosti na požadavcích aplikace existuje několik kroků, které můžete provést po přidání ověřování. Mezi vylepšení, která je možné pro tento návod provést, patří:
Přidání funkcí odesílat aktualizace databáze. Další informace naleznete v tématu Návod: Ukládání dat do databáze (jediná tabulka).
Úpravy objektu dataset přidat nebo odstranit objekty databáze. Další informace naleznete v tématu Postupy: Upravování datové sady.
Viz také
Koncepty
Vázání ovládacích prvků Windows Forms k datům v sadě Visual Studio
Příprava vaší aplikace k příjmu dat
Vázání ovládacích prvků k datům v sadě Visual Studio
Upravování dat ve vaší aplikaci