// Roxfort ZH – lépésről lépésre útmutató // Menedzselt programozás · WinForms + SQLite + Entity Framework Core · a minta ZH // alapján, az órai anyag stílusában // Hogyan használd ezt az útmutatót // A minta ZH (Hogwarts People Management System) teljes megoldása, sorrendben, // úgy, hogy a projekt minden lépés után lefordul. // A csoporttársak szerint az éles ZH nagyon hasonló, csak a nevek vagy néhány részlet // más. Ezért minden lépésnél külön jelzem, mi a váz (ez marad) és mi a változó rész (ezt a // kiírásból kell kiolvasni). // Mindig a kiírás táblázata a mérvadó. Az osztály-, property- és vezérlőnevek pontosan // úgy legyenek, ahogy ott állnak, mert a bíró név szerint keresi őket, és a kis- és nagybetű // számít. // A kódot nem fordítottam le és nem futtattam le, ezért az első build után nézd meg, // nincs-e elírás. Hogy a ZH-n milyen segédanyag használható, azt a szabályzatból // ellenőrizd. // A teljes menet egy pillantásra // 1. Előkészület: DB mappa, indítási projekt // 2. Model: a Wizard osztály // 3. Context: a DbSet felvétele // 4. Migráció és adatbázis // 5. Add form: vezérlők, események, kód // 6. StartUp form: vezérlők, események, kód // 7. Program.cs : Dependency Injection // 8. Ellenőrzés: kézzel, majd Test → Run All Tests // Az Add azért előbb jön, mint a StartUp , mert a StartUp hivatkozik rá, a Program.cs // pedig mindkettőre. A StartUp módosítása után a Program.cs ideiglenesen hibás lesz (a // régi new StartUp() hívás miatt), ezt a 7. lépés javítja. // 0. Előkészület // Mindent a Hogwarts projektben csinálj. Az Evaluation a bíró, ahhoz ne nyúlj. // Az indítási projekt a Hogwarts legyen (félkövér a nevén a Solution Explorerben, // különben jobb klikk → Set as Startup Project). // A File Explorerben nézd meg, hogy a Hogwarts projektmappában (a .csproj mellett) // van-e DB mappa. Ha nincs, hozd létre kézzel. Az SQLite nem tud mappát létrehozni, // csak fájlt, és a hiánya unable to open database file hibát okozhat. // A projekt .NET 10-es, ehhez Visual Studio 2026 ajánlott. Ha a Form Designer nem nyílik // meg (például Timed out while connecting to named pipe hiba), ez az első gyanú. // 1. Model: a Wizard osztály // Jobb klikk a Hogwarts projekten → Add → New Folder → Model . Jobb klikk a Model // mappán → Add → Class → Wizard.cs . namespace Hogwarts.Model { public class Wizard { public int ID { get; set; } public string Name { get; set; } = string.Empty; public string Role { get; set; } = string.Empty; public string? House { get; set; } public string? Patronus { get; set; } public int Class { get; set; } } } // Váz: public class , a megfelelő névtér ( Hogwarts.Model ), publikus property-k { // get; set; } -tel. Az ID nevű int property az EF-nek automatikusan elsődleges // kulcs. // Változó: a property-k nevei és típusai a kiírás táblázatából. A típusnak pontosan // egyeznie kell, a bíró ellenőrzi. Kötelező szöveges mező: string és = string.Empty; . // Opcionális mező: string? . // 2. Context: a DbSet felvétele // A Context/WizardContext.cs fájlban két dolgot adj hozzá, mást ne módosíts (ott áll, // hogy ne nyúlj hozzá): // 1. a fájl tetejére: using Hogwarts.Model; // 2. az osztályba, a _defaultConnectionString alá: public DbSet Wizards { get; set; } = null!; // Mentsd el (Ctrl+S), majd Build → Rebuild Solution. Hibátlanul le kell futnia, mert az Add- // Migration csak ilyenkor működik. // Változó: az entitás és a DbSet neve a kiírás szerint (többes szám, itt Wizards ). A DbSet // neve lesz a tábla neve, a bíró ezt keresi. // 3. Migráció és adatbázis // Tools → NuGet Package Manager → Package Manager Console. A Default project legyen // Hogwarts . Futtasd: Add-Migration InitialCreate Update-Database // Ellenőrzés az Add-Migration után: // A Migrations mappában két fájl jelenik meg: ..._InitialCreate.cs és // WizardContextModelSnapshot.cs . // Az Up metódusban lennie kell a CreateTable(name: "Wizards", ...) résznek. Ha az // Up üres, kimaradt a DbSet: Remove-Migration , javítás, újra Add-Migration . // Az An error occurred while accessing the Microsoft.Extensions.Hosting // services üzenet ártalmatlan. A siker jele a To undo this action, use Remove- // Migration. sor. // Ellenőrzés az Update-Database után: a Hogwarts/DB mappában megjelenik a // wizards.db . A File Explorerben nézd meg, a Solution Explorer nem mindig frissül. // Ha SQLite Error 14: unable to open database file hibát kapsz: // 1. Nézd meg, hogy van-e DB mappa a projektmappában. Ha nincs, hozd létre, és futtasd // újra az Update-Database -t. // 2. Ha van, de a hiba marad, a relatív útvonal ( ../../../DB/wizards.db ) a Package // Manager Console-ból rossz mappához képest értelmeződik. Két megoldás: // Teljes útvonallal: Update-Database -Connection "Data // Source=C:/Utvonal/Hogwarts/Hogwarts/DB/wizards.db" (a saját útvonaladdal, // előre döntött perjelekkel). // A program hozza létre az adatbázist: a 7. lépés Program.cs mintájában benne van a // Migrate() sor, ami induláskor a migráció alapján létrehozza a wizards.db -t. // Futtasd egyszer az alkalmazást (F5). // Fontos: a tesztek nem hozzák létre az adatbázist, hanem a Hogwarts/DB/wizards.db fájlt // keresik, benne a Wizards és az __EFMigrationsHistory táblával. Ne használj // EnsureCreated() -et, mert az nem hoz létre migrációs history táblát. // 4. Az Add form // Jobb klikk a View mappán → Add → Form (Windows Forms) → név: Add . // Vezérlők (Toolbox → húzd be, a Properties ablakban a (Name) mezőt írd át): // Vezérlő (Name) Megjegyzés // TextBox nameTextBox név, kötelező // ComboBox roleComboBox szerepkör, kötelező // ComboBox houseComboBox ház, diáknál kötelező // TextBox patronusTextBox opcionális // NumericUpDown classUpDown osztály, csak diáknál mentődik // Button addButton Text: Mentés // Button cancelButton Text: Mégse // ErrorProvider errorProvider a Designer alján jelenik meg // Minden beviteli mező mellé tegyél egy Label-t is (Név, Szerepkör, Ház, Patrónus, Osztály). // Események bekötése: jelöld ki a gombot → Properties ablakban a villám ikon (Events) → a // Click mellé gépeld be a nevet, majd Enter. A Visual Studio legenerálja a metódust. // addButton → Click → Save // cancelButton → Click → Cancel // Névszabály, ami sok bajt megelőz: a vezérlő neve és az eseménykezelő neve soha nem // lehet ugyanaz. A vezérlő főnév ( addButton ), a kezelő ige ( Save ). Ha átnevezel valamit // (F2), ellenőrizd a .Designer.cs -ben, hogy nem a vezérlő neve íródott-e át a kezelő // nevére. Ennek a jele: ... is a method, which is not valid in the given context . // Add.cs: using Hogwarts.Context; using Hogwarts.Model; using Microsoft.Extensions.DependencyInjection; namespace Hogwarts.View { public partial class Add : Form { private readonly IServiceProvider serviceProvider; public Add(IServiceProvider _serviceProvider) { serviceProvider = _serviceProvider; InitializeComponent(); roleComboBox.DropDownStyle = ComboBoxStyle.DropDownList; roleComboBox.Items.AddRange(new string[] { "diák", "oktató", "egyéb" }); houseComboBox.DropDownStyle = ComboBoxStyle.DropDownList; houseComboBox.Items.AddRange(new string[] { "", "Griffendél", "Mardekár", "Hollóhát", "Hugrabug" }); classUpDown.Minimum = 0; classUpDown.Maximum = 7; } private void Save(object sender, EventArgs e) { errorProvider.Clear(); string name = nameTextBox.Text.Trim(); string? role = roleComboBox.SelectedItem?.ToString(); string? house = houseComboBox.SelectedItem?.ToString(); string patronus = patronusTextBox.Text.Trim(); if (name.Length == 0) errorProvider.SetError(nameTextBox, "A név kötelező!"); if (string.IsNullOrEmpty(role)) errorProvider.SetError(roleComboBox, "A szerepkör kötelező!"); bool isStudent = role == "diák"; if (isStudent && string.IsNullOrEmpty(house)) errorProvider.SetError(houseComboBox, "Diákoknál a ház kötelező!"); if (errorProvider.HasErrors) return; var context = serviceProvider.GetRequiredService(); context.Wizards.Add(new Wizard { Name = name, Role = role!, House = string.IsNullOrEmpty(house) ? null : house, Patronus = patronus.Length == 0 ? null : patronus, Class = isStudent ? (int)classUpDown.Value : 0 }); context.SaveChanges(); DialogResult = DialogResult.OK; } private void Cancel(object sender, EventArgs e) { DialogResult = DialogResult.Cancel; } } } // Mire figyelj: // A classUpDown.Minimum legyen 0, mert a bíró teszt 0-t állít be, és 1-es minimumnál az // kivételt dobna. // A SelectedItem?.ToString() a ?. miatt null -t ad vissza, ha nincs kiválasztva // semmi. Enélkül kivételt kapnál. // A houseComboBox első eleme egy üres szöveg. Egy DropDownList -ből egyébként nem // lehet visszaállni üresre, az oktatóknál viszont maradhat üresen a ház. // Hiba esetén a return után nincs mentés, és a DialogResult None marad. A teszt ezt // várja. // Sikeres mentésnél a DialogResult = OK bezárja a ShowDialog() -gal megnyitott // ablakot, külön Close() nem kell. // Ne adj hozzá a kiírásban nem szereplő szabályt (például hogy a diáknak kötelező az // osztály). A bíró más adatokkal is próbálhat, és az ilyen plusz szabály buktathat. // Váz és változó rész: // Váz (marad): konstruktor IServiceProvider -rel, ComboBox-ok feltöltése, Save : // errorProvider.Clear() → mezők kiolvasása → validáció → HasErrors esetén // return → Add és SaveChanges() → DialogResult.OK . Cancel : // DialogResult.Cancel . // Változó (kiírásból): melyik mező kötelező és mikor, a ComboBox-ok elemei, mi // mentődik feltételesen, a vezérlők nevei. // 5. A StartUp form // Nyisd meg a View/StartUp.cs fájlt Designerben (dupla klikk). // Vezérlő (Name) Beállítás // DataGridView wizardGridView ReadOnly = True, AllowUserToAddRows = // False, AllowUserToDeleteRows = False // Button listButton Text: Listázás // Button addButton Text: Hozzáadás // Form (az üres részére Text: Roxfort Varázslóképző // kattintva) // Az addButton név itt nem ütközik az Add form addButton -jával, mert külön osztályban // vannak. // Események (villám ikon → Click vagy Load → név, Enter): // listButton → Click → ListWizards // addButton → Click → AddWizard // maga a Form (kattints az üres részére) → Load → válaszd ki a legördülő listából a // ListWizards -t // StartUp.cs: using Hogwarts.Context; using Microsoft.Extensions.DependencyInjection; namespace Hogwarts.View { public partial class StartUp : Form { private readonly IServiceProvider serviceProvider; public StartUp(IServiceProvider _serviceProvider) { serviceProvider = _serviceProvider; InitializeComponent(); } private void ListWizards(object sender, EventArgs e) { var context = serviceProvider.GetRequiredService(); wizardGridView.DataSource = context.Wizards .OrderBy(w => w.Role) .ThenBy(w => w.Class) .ThenBy(w => w.House) .Select(w => new { w.Name, w.Role, w.House, w.Patronus, w.Class }) .ToList(); } private void AddWizard(object sender, EventArgs e) { using var window = serviceProvider.GetRequiredService(); window.ShowDialog(); if (window.DialogResult == DialogResult.OK) ListWizards(sender, e); } } } // Mire figyelj: // Az első rendezési szempont OrderBy , a többi ThenBy . Ha mindhárom OrderBy lenne, // az utolsó felülírná az előzőeket. // Az ID azért nem látszik, mert nincs benne a Select -ben. Az órai anyag a rácsban rejti // el az oszlopot, de a kiírás ezt kifejezetten tiltja ("ne a wizardGridView rejtse el"), tehát a // Select az elvárt megoldás. // A Load esemény miatt töltődik fel a rács induláskor. A bíró teszt a Form létrehozása // után szúr be adatot, és csak utána jeleníti meg, tehát a konstruktorban lekérdezve üres // maradna. // A Select névtelen típusának property-nevei lesznek az oszlopnevek. A teszt Name // nevű oszlopot keres. // A _serviceProvider név csak a konstruktoron belül él, a többi metódusban a // serviceProvider mezőt használd. // Váz és változó rész: // Váz (marad): konstruktor, lekérdezés a contextből, DataSource , AddWizard a // ShowDialog + DialogResult.OK mintával. // Változó (kiírásból): rendezés, szűrés, melyik oszlop látszik (a Select tartalma), a // vezérlők nevei. // 6. Program.cs (Dependency Injection) // Cseréld le a teljes tartalmát. A kiinduló new StartUp() hívás már nem fordulna le, mert a // StartUp konstruktora paramétert vár. using Hogwarts.Context; using Hogwarts.View; using Microsoft.EntityFrameworkCore; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; namespace Hogwarts { internal static class Program { [STAThread] static void Main() { ApplicationConfiguration.Initialize(); var host = Host.CreateDefaultBuilder() .ConfigureServices((context, services) => { services.AddSingleton(); services.AddTransient(); services.AddTransient(); }).Build(); using var serviceScope = host.Services.CreateScope(); // Csak akkor kell, ha az Update-Database hibázott (lásd 3. lépés). // Ha az adatbázis már megvan, nem csinál semmit. serviceScope.ServiceProvider.GetRequiredService().Database.Migrate(); var startForm = serviceScope.ServiceProvider.GetRequiredService(); Application.Run(startForm); } } } // Váz (marad): Host.CreateDefaultBuilder() , a regisztrációk ( AddSingleton a // context-re, AddTransient a Formokra), a főablak elkérése a GetRequiredService - // szel. // Változó (kiírásból): melyik osztály Singleton és melyik Transient, és a Formok nevei. Az // Application.SetHighDpiMode(...) sor az órai anyagban szerepel, a feladathoz nem // szükséges. // Indítsd el az alkalmazást (F5). Egy üres rácsnak kell megjelennie, és a // Hogwarts/DB/wizards.db fájlnak léteznie kell. // 7. Ellenőrzés // Kézzel: // 1. Üresen mentve a névnél és a szerepkörnél piros jelzést kell kapnod. // 2. Diákként ház nélkül a háznál kell hibajelzés. // 3. Egy rendes diák (szerepkör: diák, ház: Griffendél, osztály: 5) mentése után az ablak // bezárul, és megjelenik a rácsban. // 4. Egy oktató ház nélkül is menthető. // 5. Indítsd újra a programot: az adatoknak ott kell lenniük. // Bíró: menü Test → Run All Tests. Az eredmény a Test Explorerben látszik, a 8 tesztnek // zöldnek kell lennie. A teszt kitörölheti a próbaadataidat, ez normális. A tesztek futtatása // előtt a wizards.db -nek léteznie kell. A bíró nem feltétlenül pontosan ezeket a teszteket // futtatja (más adatokkal próbálhat), ezért a kiírás szabályait kövesd, ne többet és ne // kevesebbet. // 8. Ha a ZH más, mint a minta // A csoporttársak szerint a ZH nagyon hasonló lesz. Ezek a legvalószínűbb eltérések, és így // kezeld őket. // Más nevek, más entitás. Ha például Wizard helyett Student van, mindenhol cseréld: a // modell osztály, a DbSet neve, a Hogwarts.Model. névtér, a vezérlők és az // eseménykezelők nevei. A kiírás táblázata a mérvadó, minden nevet onnan másolj. // Más rendezés. Csökkenő sorrend: OrderByDescending és ThenByDescending . .OrderByDescending(w => w.Name) .ThenBy(w => w.Class) // Szűrés. A Where a rendezés elé kerül. context.Wizards .Where(w => w.Role == "oktató") .OrderBy(w => w.Name) .Select(w => new { w.Name, w.Role }) .ToList(); // Más oszlopok látszanak. Csak azok kerüljenek a Select -be, amelyeket látni kell. // Más validáció. Számmező TextBox-ból (órai anyag, 2. gyakorlat, Input validation): if (!int.TryParse(valamiTextBox.Text, out int ertek)) errorProvider.SetError(valamiTextBox, "Nem érvényes szám!"); // Dátum esetén a DateTimePicker Value tulajdonságát használd (2. gyakorlat, Date). // Minden hibához külön SetError , a végén a HasErrors ellenőrzés. // Szerkesztés vagy törlés. Ha a ZH ilyet kér, az órai anyag 3. gyakorlatában találod a mintát: // a CellMouseClick esemény ( EditProduct ), a property-vel átadott entitás ("property // injection"), a Load esemény a mezők feltöltéséhez ( Loaded ) és a törlés // ( DeleteProduct ). A minta IDatabase -t használ, a ZH-n viszont közvetlenül a contextet // kérd el ( context.Remove(...) , context.SaveChanges() ). // Eltérő Singleton és Transient regisztráció. A Program.cs -ben csak az AddSingleton és // AddTransient sorok változnak. // 9. Hibakereső // Tünet Valószínű ok // Az Up metódus üres a migrációban A DbSet hiányzott a contextből. Remove- // Migration , javítás, újra Add-Migration . // SQLite Error 14: unable to open Hiányzik a DB mappa, vagy a PMC relatív // database file útvonala rossz. Lásd a 3. lépést ( - // Connection vagy Migrate() ). // A teszt nem találja a Wizard osztályt Rossz projektben van ( Evaluation ), nem // public , vagy rossz a névtér. // ... is a method, which is not valid A vezérlő és az eseménykezelő neve azonos. // in the given context Nevezd át a vezérlőt a kiírás szerinti névre, a // kezelőt igére ( Save ). // Ambiguity between ... Egy vezérlő kétszer van deklarálva a // .Designer.cs -ben. A duplikátumot töröld. // Tünet Valószínű ok // Fordítási hiba egy ...CellContentClick Törölt eseménykezelőre hivatkozó sor maradt // miatt a .Designer.cs -ben. Töröld a sort. // A Designer hibát mutat, a build viszont Mentés (Ctrl+Shift+S), a Designer fül // tiszta bezárása, Rebuild Solution, a Designer // újranyitása. Ha ez sem segít, a Visual Studio // újraindítása. // Üres a lista induláskor A ListWizards nincs bekötve a Form Load // eseményére. // Üres rács a bíróban, de kézzel működik A listázás a konstruktorban fut a Load // helyett. // Kivétel mentéskor üres ComboBox-szal Hiányzik a ?. a // SelectedItem?.ToString() -ből. // Value ... out of range kivétel a teszten A classUpDown.Minimum nem 0. // A Program.cs nem fordul A new StartUp() hívás még a régi. Cseréld a // 6. lépés kódjára. // 10. Puska: a váz fejből // Save (Add form): // 1. errorProvider.Clear(); // 2. mezők kiolvasása ( Text.Trim() , SelectedItem?.ToString() , // (int)NumericUpDown.Value ) // 3. validáció: minden hibára egy errorProvider.SetError(vezérlő, "üzenet") // 4. if (errorProvider.HasErrors) return; // 5. context..Add(new { ... }); context.SaveChanges(); // 6. DialogResult = DialogResult.OK; // Cancel: DialogResult = DialogResult.Cancel; // ListWizards (StartUp): GetRequiredService() → // .OrderBy(...).ThenBy(...).Select(új névtelen típus).ToList() → DataSource . // Bekötés: a gomb Click és a Form Load eseményére is. // AddWizard (StartUp): using var window = // serviceProvider.GetRequiredService(); window.ShowDialog(); if // (window.DialogResult == DialogResult.OK) ListWizards(sender, e); // Program.cs: Host.CreateDefaultBuilder().ConfigureServices(...) → // AddSingleton() , AddTransient() , AddTransient() → // Build() → CreateScope() → GetRequiredService() → // Application.Run(...) . // Migráció: Add-Migration , Update-Database (vagy Migrate() a Program.cs-ben), // és a DB mappának léteznie kell. // Hova nézz az órai anyagban: // Mit keresel Hol // Program.cs , DI regisztráció 3. gyakorlat, Dependency Injection // Form konstruktor IServiceProvider -rel, 3. gyakorlat, List and Modify Orders // GetRequiredService , ShowDialog // Vezérlők, események bekötése (villám ikon) 2. gyakorlat, Event Handling // errorProvider.SetError , Clear 2. gyakorlat, Input validation // Load esemény 3. gyakorlat, a Loaded metódus // Context, DbSet , migráció 4. gyakorlat // ComboBox és NumericUpDown használata a ZH kiírás Segédlet része