A C# alapból nem tud SQLite adatbázist kezelni. Ehhez egy külső csomagra van szükség. A csomagokat a NuGet csomagkezelőn keresztül telepítjük: ez egy beépített Visual Studio-szolgáltatás, amely letölti a csomagot, és hozzáadja a projekthez. A tanfolyamban a System.Data.SQLite csomagot használjuk.

1. Hozz létre egy új Windows Forms projektet (0.4 lecke), például AdatbazisProjekt néven.
2. A Solution Explorerben kattints jobb gombbal a projektre (nem a Solutionre), és válaszd a Manage NuGet Packages… menüpontot.
3. A Browse lapon keresd meg a System.Data.SQLite csomagot, jelöld ki a stabil (nem előzetes, nem prerelease) változatát, majd kattints az Install gombra.
4. Fogadd el a licencet és a változtatások listáját (Apply, I Accept).

A csomag változata és a projekt típusa

A System.Data.SQLite több változatban létezik, és a projekt típusához kell igazodni: a .NET Framework projekthez a hagyományos csomag való, az újabb .NET projektekhez is van támogatott változat. Ha a telepítés hibát jelez, vagy a using System.Data.SQLite; sor piros marad, nézd meg a csomag leírását, hogy az adott keretrendszert támogatja-e. A tanfolyam példái a .NET Framework 4.7.2 projekten futottak. (Az újabb .NET világban gyakran használt másik csomag a Microsoft.Data.Sqlite, de a példakódok a System.Data.SQLite osztályait használják.)

Jósolj!

A telepítés után a Solution Explorerben a projekt References (vagy Dependencies) részében mi jelenik meg? Mi változik a bin\Debug mappában a program első fordítása után?

A program futáskor a bin\Debug mappából fut (az Output Directory, vagyis a kimeneti mappa), ezért az adatbázisnak is ott kell lennie. A projekt mappájából nem automatikusan másolódik át. A legegyszerűbb megoldás, ha a .db fájlt a projekthez adod, és megadod, hogy a fordító másolja:

1. Másold a belepes.db fájlt a projekt mappájába (ahol a Form1.cs van).
2. A Solution Explorerben jobb gombbal a projektre → Add → Existing Item, válaszd ki a belepes.db fájlt.
3. Kattints a fájlra, és a Properties ablakban állítsd a Copy to Output Directory értékét Copy if newer-re.

Az adatbázis-kapcsolat létrehozását egy külön osztályba tesszük. Ha a program több helyén is kell adatbázist elérni, nem kell mindenhol megismételni a kapcsolati szöveget, és ha változik (például más fájlnév), elég egy helyen javítani. A projekten jobb gombbal: Add → Class, a fájl neve DB.cs:

using System;
using System.Data.SQLite;
using System.IO;
using System.Windows.Forms;

internal static class DB
{
    private static readonly string AdatbazisUt = Path.Combine(Application.StartupPath, "belepes.db");

    public static SQLiteConnection UjKapcsolat()
    {
        if (!File.Exists(AdatbazisUt))
        {
            throw new FileNotFoundException("Nem található az adatbázis: " + AdatbazisUt);
        }

        return new SQLiteConnection("Data Source=" + AdatbazisUt + ";Version=3;");
    }
}

Miért ellenőrizzük a fájl létezését?

Az SQLite hajlamos hiányzó fájl esetén egy új, üres adatbázist létrehozni. Ilyenkor a program látszólag működik, de az adatbázis üres, és később a „no such table” (nincs ilyen tábla) hibát kapod. A File.Exists ellenőrzéssel ezt a hibát előre, érthetően jelezzük.

Az adatbázis-kapcsolat egy erőforrás: használat után le kell zárni, különben a fájl zárolva maradhat, és a következő művelet hibát ad. A using blokk automatikusan gondoskodik a lezárásról, akkor is, ha közben hiba történik:

using (SQLiteConnection kapcsolat = DB.UjKapcsolat())
{
    kapcsolat.Open();

    // itt használhatod a kapcsolatot

}   // ide érve a kapcsolat automatikusan lezárul

Jósolj!

Egy using blokkon belül megnyitsz egy kapcsolatot, majd a blokk közepén hiba történik (kivétel keletkezik). Lezáródik a kapcsolat?

Készítsünk egy kapcsolat-tesztet: egy gomb megnyitja az adatbázist, és kiírja, hány felhasználó van a belepesi_adatok táblában. A lekérdezést egy SQLiteCommand (SQL parancs) objektum hajtja végre. Tegyél az ablakra egy btnTeszt gombot és egy lblEredmeny feliratot, és a fájl elejére a using System.Data.SQLite; sort:

private void btnTeszt_Click(object sender, EventArgs e)
{
    try
    {
        using (SQLiteConnection kapcsolat = DB.UjKapcsolat())
        {
            kapcsolat.Open();

            using (SQLiteCommand parancs = new SQLiteCommand("SELECT COUNT(*) FROM belepesi_adatok", kapcsolat))
            {
                int db = Convert.ToInt32(parancs.ExecuteScalar());
                lblEredmeny.Text = $"A táblában {db} felhasználó van.";
            }
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show("Adatbázis-hiba: " + ex.Message);
    }
}

Az SQLiteCommand háromféleképpen hajthatja végre az SQL-t. Később mindhármat használjuk:

Jósolj!

A 3.1 leckében három felhasználót vettél fel. Mit ír ki a program a gomb megnyomása után? Mi történik, ha átnevezed a belepes.db fájlt a bin\Debug mappában?

Mi a baj, és hogyan javítod?

Gondold végig az okot, és csak utána nyisd le a megoldást.

1. Ismeretlen típus

// CS0246: The type or namespace name 'SQLiteConnection' could not be found

2. no such table

// SQLiteException: SQL logic error: no such table: belepesi_adatok

3. Nem tölthető be a natív rész

// DllNotFoundException: Unable to load DLL 'SQLite.Interop.dll'

4. database is locked

// SQLiteException: database is locked

5. A kapcsolat zárva van

using (SQLiteConnection kapcsolat = DB.UjKapcsolat())
{
    using (SQLiteCommand parancs = new SQLiteCommand("SELECT COUNT(*) FROM belepesi_adatok", kapcsolat))
    {
        parancs.ExecuteScalar();
    }
}
// InvalidOperationException: a kapcsolat nincs megnyitva

Három önálló gyakorlófeladat

Egyszerre csak egyet csinálj: tervezd meg, írd meg, futtasd, ellenőrizd, és csak utána nyisd ki a megoldást.

// a DB osztályban az AdatbazisUt legyen public:
public static readonly string AdatbazisUt = Path.Combine(Application.StartupPath, "belepes.db");

// a Form1_Load eseményben:
lblUt.Text = DB.AdatbazisUt;

using (SQLiteCommand parancs = new SQLiteCommand("SELECT COUNT(*) FROM adatok WHERE cim = 'Veszprém'", kapcsolat))
{
    int db = Convert.ToInt32(parancs.ExecuteScalar());
    lblEredmeny.Text = $"Veszprémi dolgozók: {db}";
}

Három szinten gyakorolhatsz: alap, közepes és kihívás. A feladatokhoz a 3.2 lecke projektje kell: DB.cs, a belepes.db a belepesi_adatok és adatok táblával, egy lblEredmeny felirat. Csak a próbálkozás után nyisd le a megoldást.

Alap szint

private void btnDolgozok_Click(object sender, EventArgs e)
{
    try
    {
        using (SQLiteConnection kapcsolat = DB.UjKapcsolat())
        {
            kapcsolat.Open();

            using (SQLiteCommand parancs = new SQLiteCommand("SELECT COUNT(*) FROM adatok", kapcsolat))
            {
                int db = Convert.ToInt32(parancs.ExecuteScalar());
                lblEredmeny.Text = $"{db} dolgozó van az adatbázisban.";
            }
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show("Adatbázis-hiba: " + ex.Message);
    }
}

SQLiteConnection kapcsolat = DB.UjKapcsolat();

try
{
    kapcsolat.Open();
    // ... a lekérdezés ...
}
finally
{
    kapcsolat.Close();
}

Közepes szint

object eredmeny = parancs.ExecuteScalar();

if (eredmeny == null || eredmeny == DBNull.Value)
{
    lblEredmeny.Text = "Nincs adat az átlagszámításhoz.";
}
else
{
    double atlag = Convert.ToDouble(eredmeny);
    lblEredmeny.Text = "Az átlagfizetés: " + Math.Round(atlag) + " Ft";
}

SQLiteConnection kapcsolat = DB.UjKapcsolat();

kapcsolat.Open();
string nyitva = kapcsolat.State.ToString();

kapcsolat.Close();
string zarva = kapcsolat.State.ToString();

lblEredmeny.Text = $"Megnyitás után: {nyitva}, bezárás után: {zarva}";

Kihívás szint

try
{
    // ... a kapcsolat és a lekérdezés ...
}
catch (System.IO.FileNotFoundException)
{
    MessageBox.Show("Az adatbázisfájl hiányzik. Ellenőrizd a Copy to Output Directory beállítást!");
}
catch (SQLiteException ex)
{
    MessageBox.Show("Adatbázis-hiba (például hiányzó tábla): " + ex.Message);
}
catch (Exception ex)
{
    MessageBox.Show("Váratlan hiba: " + ex.Message);
}

private void btnInfo_Click(object sender, EventArgs e)
{
    System.IO.FileInfo info = new System.IO.FileInfo(DB.AdatbazisUt);

    if (!info.Exists)
    {
        lblEredmeny.Text = "Az adatbázisfájl nem található.";
        return;
    }

    lblEredmeny.Text = $"{info.Name}, {info.Length} bájt, módosítva: {info.LastWriteTime}";
}

Gyors önellenőrzés

Válaszolj fejben, és csak utána nyisd le a választ.