Przejdź do głównej zawartości

Instrukcja tworzenia kontekstu bazy danych SQLite w C# z użyciem Entity Framework Core

Jeśli masz ochotę to postaw kawę, będzie to motywacja do kolejnej pracy https://buycoffee.to/emilcsharp

Instrukcja tworzenia kontekstu bazy danych SQLite w C# z użyciem Entity Framework Core

Ta instrukcja krok po kroku wyjaśnia, jak stworzyć i skonfigurować kontekst bazy danych SQLite w aplikacji C# wykorzystując Entity Framework Core (EF Core). Wykorzystuje ona dostarczony kod źródłowy i opisuje poszczególne elementy.

Wymagania wstępne:

  • Visual Studio: Zainstalowany Visual Studio (lub inny IDE obsługujący C#).

  • .NET SDK: Zainstalowany .NET SDK (minimum wersja .NET 6, ale zalecana nowsza).

  • Entity Framework Core: Dodanie zależności EF Core do projektu. Można to zrobić za pomocą NuGet Package Manager:

    dotnet add package Microsoft.EntityFrameworkCore.SQLite
    dotnet add package Microsoft.EntityFrameworkCore.Tools
    
  • Biblioteka SQLite: Upewnij się, że masz zainstalowaną bibliotekę SQLite dla platformy, na której uruchamiasz aplikację (np. SQLite.Interop w przypadku Windows). NuGet może to zrobić automatycznie, ale warto sprawdzić.

Kroki:

  1. Struktura projektu: Upewnij się, że masz strukturę projektu odpowiadającą podanemu kodowi. Kod zakłada, że znajduje się wewnątrz namespace SafeNote.Inne.

  2. Analiza kodu i wyjaśnienie poszczególnych fragmentów:

    • using Microsoft.EntityFrameworkCore;: Importuje niezbędne klasy z biblioteki EF Core.

    • using System;, using System.IO;: Importują klasę Environment i funkcje obsługi plików, używane do określenia ścieżki bazy danych w folderze AppData.

    • AppDbContext : DbContext: Tworzy klasę kontekstu bazy danych AppDbContext, dziedzicząc po klasie DbContext z EF Core. Kontekst ten odpowiada za interakcję z bazą danych.

    • private readonly string _dbPath;: Definiuje prywatną, niezmienną zmienną _dbPath typu string, która przechowuje pełną ścieżkę do pliku bazy danych SQLite.

    • AppDbContext() (konstruktor):

      • Określa folder aplikacji Safenote w katalogu AppData użytkownika za pomocą Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData). Jest to standardowe miejsce dla przechowywania plików aplikacji na platformie Windows.
      • Sprawdza, czy folder Safenote istnieje. Jeśli nie, tworzy go za pomocą Directory.CreateDirectory().
      • Tworzy pełną ścieżkę do pliku bazy danych (np. C:\Users\Użytkownik\AppData\Roaming\Safenote\safenote.db) łącząc folder Safenote i nazwę pliku "safenote.db" za pomocą Path.Combine().
      • Wywołuje this.Database.EnsureCreated(), która gwarantuje, że baza danych zostanie utworzona, jeśli nie istnieje. Jest to wygodne rozwiązanie zapewniające spójność bazy danych.
    • OnConfiguring(DbContextOptionsBuilder optionsBuilder):

      • To metoda nadpisująca, która pozwala skonfigurować połączenie z bazą danych. Używa optionsBuilder do ustawienia connection stringa dla SQLite: optionsBuilder.UseSqlite($"Data Source={_dbPath}");. To właśnie tutaj określamy ścieżkę do pliku bazy danych.
    • OnModelCreating(ModelBuilder modelBuilder):

      • To metoda nadpisująca, która pozwala na definiowanie mapowań między klasami C# (modelami danych) a tabelami w bazie danych. Można tutaj zdefiniować relacje między tabelami i ustawić klucze podstawowe/obce. W podanym kodzie jest pusta, ale można ją rozbudować o definicje modeli danych.
    • public DbSet<Uzytkownik> Uzytkownicy { get; set; }, public DbSet<Kategoria> Kategorie { get; set; }, public DbSet<Notatka> Notatki { get; set; }:

      • Definiują DbSet dla każdego modelu danych (klasy reprezentujące tabele w bazie danych). DbSet jest używany do zarządzania tabelami w bazie danych i umożliwia wykonywanie operacji CRUD (Create, Read, Update, Delete) na tych tabelach.
  3. Użycie kontekstu bazy danych: Po utworzeniu klasy AppDbContext, można ją użyć do interakcji z bazą danych:

    using (var dbContext = new AppDbContext())
    {
        // Dodawanie nowych notatek
        var nowaNotatka = new Notatka { Tytul = "Moja pierwsza notatka", Zawartosc = "Tekst notatki" };
        dbContext.Notatki.Add(nowaNotatka);
    
        // Zapisywanie zmian w bazie danych
        dbContext.SaveChanges();
    
        // Odczytanie wszystkich notatek
        var wszystkieNotatki = dbContext.Notatki.ToList();
    
        foreach (var notatka in wszystkieNotatki)
        {
            Console.WriteLine($"Tytuł: {notatka.Tytul}, Zawartość: {notatka.Zawartosc}");
        }
    }
    

Pełna klasa AppDbContext:

using Microsoft.EntityFrameworkCore;
using System;
using System.IO;
using SafeNote.Models;

namespace SafeNote.Inne
{
    internal class AppDbContext : DbContext
    {
        private readonly string _dbPath;

        public AppDbContext()
        {
            // Ścieżka do folderu aplikacji Safenote w AppData
            string safenoteFolder = Path.Combine(
                Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
                "Safenote");

            // Jeśli folder nie istnieje, tworzymy go
            if (!Directory.Exists(safenoteFolder))
            {
                Directory.CreateDirectory(safenoteFolder);
            }

            // Pełna ścieżka do pliku bazy
            _dbPath = Path.Combine(safenoteFolder, "safenote.db");
            this.Database.EnsureCreated();
        }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            // Ustaw poprawny connection string do SQLite
            optionsBuilder.UseSqlite($"Data Source={_dbPath}");
        }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            // Możesz tutaj mapować relacje i klucze, jeśli jest potrzeba
        }

        public DbSet<Uzytkownik> Uzytkownicy { get; set; }
        public DbSet<Kategoria> Kategorie { get; set; }
        public DbSet<Notatka> Notatki { get; set; }
    }
}

Tutaj kolejny przykład z wygodniejszym kontekstem wystarczy wkleić i dodać dbsety:

using Microsoft.EntityFrameworkCore; using OrganizatorPracyPremiumV1.Models; using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace OrganizatorPracyPremiumV1.Baza { internal class AppDbContext:DbContext { private readonly string _dbPath; string nazwaProgramu = "OrganizatorPracyPremium"; public AppDbContext() { // Ścieżka do folderu aplikacji Safenote w AppData string safenoteFolder = Path.Combine( Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), nazwaProgramu); // Jeśli folder nie istnieje, tworzymy go if (!Directory.Exists(safenoteFolder)) { Directory.CreateDirectory(safenoteFolder); } // Pełna ścieżka do pliku bazy _dbPath = Path.Combine(safenoteFolder, nazwaProgramu); this.Database.EnsureCreated(); } protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) { // Ustaw poprawny connection string do SQLite optionsBuilder.UseSqlite($"Data Source={_dbPath}"); } protected override void OnModelCreating(ModelBuilder modelBuilder) { // Możesz tutaj mapować relacje i klucze, jeśli jest potrzeba } public DbSet<User> Uzytkownicy { get; set; } } }


Dodatkowe uwagi:

  • Obsługa błędów: W środowisku produkcyjnym należy dodać obsługę wyjątków (try-catch) do operacji bazy danych, aby obsłużyć potencjalne błędy i zapobiec awarii aplikacji.
  • Transakcje: Używaj transakcji (dbContext.Database.BeginTransaction()) dla krytycznych operacji, które muszą być wykonywane w sposób atomowy (wszystkie zmiany są albo zapisywane, albo cofane).
  • Konfiguracja SQLite: Możesz rozważyć dodatkową konfigurację biblioteki SQLite (np. ustawienie rozmiaru bufora) dla poprawy wydajności.
  • Database.EnsureCreated(): Ta metoda automatycznie tworzy bazę danych i tabele na podstawie modeli danych (klas Uzytkownik, Kategoria, Notatka). Jeśli modele danych się zmienią, należy ponownie uruchomić tę metodę, aby zaktualizować strukturę bazy danych.
  • Bezpieczeństwo: Zabezpiecz plik bazy danych, szczególnie jeśli zawiera wrażliwe dane. Upewnij się, że uprawnienia dostępu do pliku są odpowiednio ustawione.

Podsumowanie:

Powyższe instrukcje pokazują, jak skutecznie skonfigurować kontekst bazy danych SQLite w aplikacji C# przy użyciu EF Core. Dzięki temu można łatwo i bezpiecznie zarządzać danymi w bazie danych SQLite. Pamiętaj o odpowiedniej konfiguracji i obsłudze błędów dla stabilnej pracy aplikacji.

Komentarze

Popularne posty z tego bloga

Instalacja android TV na komputerze

Jeśli masz ochotę to postaw kawę, będzie to motywacja do kolejnej pracy https://buycoffee.to/emilcsharp Instrukcja instalacji Android TV z ISO i konfiguracji dual boot z Windows za pomocą Grub2Win Poniżej znajdziesz szczegółową, krok po kroku instrukcję, jak zainstalować Android TV obok Windows, korzystając z Grub2Win oraz wybranego obrazu ISO. 1. Pobranie obrazu ISO Android TV Pobierz plik ISO Android TV z poniższego linku na swój komputer: https://drive.google.com/file/d/1fE60copiNjOma89ZLNMyxWW45yN9S8fo/view 2. Instalacja Grub2Win Przejdź na stronę: https://grub2win.com/ Pobierz i zainstaluj program Grub2Win zgodnie z instrukcjami instalatora. 3. Przygotowanie partycji dla Android TV Otwórz zarządzanie dyskami w Windows (naciśnij Windows + X → „Zarządzanie dyskami”). Wybierz dysk o wystarczającej ilości wolnego miejsca. Zmniejsz wybrany wolumin lub użyj wolnego obszaru aby utworzyć nową partycję o rozmiarze minimum 30GB (system plików NTFS). Nadaj partycji unikalną nazwę np. ANDRO...

Perplexica czyli lokalne AI poradnik

Jeśli masz ochotę to postaw kawę, będzie to motywacja do kolejnej pracy https://buycoffee.to/emilcsharp ## Zwiększ Produktywność z Perplexica – Twoja Nowa AI-Powered Wyszukiwarka! ☕ Masz ochotę na kawę? Postaw ją i przygotuj się do zwiększenia swojej produktywności dzięki Perplexica, innowacyjnej wyszukiwarce opartej na sztucznej inteligencji.  Perplexica pomoże Ci znaleźć informacje szybciej i efektywniej niż kiedykolwiek wcześniej! **Jak to działa?** Perplexica wykorzystuje najnowsze modele językowe (LLM) do zrozumienia Twoich zapytań i dostarczania trafnych wyników.  **Zacznij od Instalacji:** 1. **Docker – Podstawa Kontekstu:**  Perplexica działa najlepiej dzięki kontenerowi Dockera, który zapewnia izolowane środowisko dla aplikacji.    * Pobierz i zainstaluj Dockera: [https://www.docker.com/](https://www.docker.com/) 2. **Wirtualizacja – Włączenie w Biosie:** Upewnij się, że wirtualizacja jest włączona w BIOSie komputera.  Zazwyczaj można to znaleźć ...

Instalacja sztucznej inteligencji lokalnie

Jeśli masz ochotę to postaw kawę, będzie to motywacja do kolejnej pracy https://buycoffee.to/emilcsharp ## Poradnik: Instalacja LM Studio i Konfiguracja Gemma-3N Ten poradnik przeprowadzi Cię przez proces instalacji LM Studio, popularnego interfejsu użytkownika do uruchamiania modeli językowych lokalnie, oraz konfiguracji modelu Gemma-3N. **Co to jest LM Studio?** LM Studio to aplikacja desktopowa umożliwiająca łatwe pobieranie i uruchamianie dużych modeli językowych (LLM) na Twoim komputerze, bez konieczności połączenia z internetem po początkowym pobraniu modelu. Oferuje prosty interfejs użytkownika, który ułatwia eksperymentowanie z różnymi modelami i ustawieniami. **Co to jest Gemma-3N?** Gemma-3N to seria modeli językowych od Google DeepMind, znanych ze swojej wydajności i otwartej dostępności. Jest to świetny wybór dla osób poszukujących modelu do eksperymentów lokalnych, oferujący dobrą jakość generowanego tekstu przy stosunkowo niskich wymaganiach sprzętowych. --- ### **Krok ...