Przewodnik: dostosowywanie zachowania wstawiania, aktualizowania i usuwania klas jednostek

  • Artykuł

Uwaga

Zestawy danych i powiązane klasy to starsze technologie .NET Framework z początku 2000 roku, które umożliwiają aplikacjom pracę z danymi w pamięci, gdy aplikacje są odłączone od bazy danych. Są one szczególnie przydatne w przypadku aplikacji, które umożliwiają użytkownikom modyfikowanie danych i utrwalanie zmian z powrotem w bazie danych. Mimo że zestawy danych okazały się bardzo udaną technologią, zalecamy, aby nowe aplikacje platformy .NET używały platformy Entity Framework Core. Program Entity Framework zapewnia bardziej naturalny sposób pracy z danymi tabelarycznymi jako modelami obiektów i ma prostszy interfejs programowania.

Narzędzia LINQ to SQL w programie Visual Studio udostępnia wizualną powierzchnię projektową służącą do tworzenia i edytowania klas LINQ to SQL (klas jednostek) opartych na obiektach w bazie danych. Korzystając z linQ to SQL, można użyć technologii LINQ do uzyskiwania dostępu do baz danych SQL. Aby uzyskać więcej informacji, zobacz LINQ (Zapytanie zintegrowane w języku).

Domyślnie logika do wykonywania aktualizacji jest dostarczana przez środowisko uruchomieniowe LINQ to SQL. Środowisko uruchomieniowe tworzy domyślne Insertinstrukcje , Updatei Delete na podstawie schematu tabeli (definicje kolumn i podstawowe informacje o kluczu). Jeśli nie chcesz używać domyślnego zachowania, możesz skonfigurować zachowanie aktualizacji i wyznaczyć określone procedury składowane do wykonywania niezbędnych wstawiania, aktualizacji i usuwania wymaganych do pracy z danymi w bazie danych. Można to również zrobić, gdy domyślne zachowanie nie jest generowane, na przykład gdy klasy jednostek są mapowane na widoki. Ponadto można zastąpić domyślne zachowanie aktualizacji, gdy baza danych wymaga dostępu do tabeli za pomocą procedur składowanych. Aby uzyskać więcej informacji, zobacz Dostosowywanie operacji przy użyciu procedur składowanych.

Uwaga

Ten przewodnik wymaga dostępności procedur składowanych InsertCustomer, UpdateCustomer i DeleteCustomer dla bazy danych Northwind.

Ten przewodnik zawiera kroki, które należy wykonać, aby zastąpić domyślne zachowanie czasu wykonywania LINQ to SQL na potrzeby zapisywania danych z powrotem do bazy danych przy użyciu procedur składowanych.

W tym przewodniku dowiesz się, jak wykonywać następujące zadania:

  • Utwórz nową aplikację windows Forms i dodaj do niej plik LINQ to SQL.

  • Utwórz klasę jednostki zamapowana na tabelę Northwind Customers .

  • Utwórz źródło danych obiektu, które odwołuje się do klasy LINQ to SQL Customer .

  • Utwórz formularz systemu Windows zawierający element DataGridView powiązany z klasą Customer .

  • Zaimplementuj funkcję zapisywania formularza.

  • Tworzenie DataContext metod przez dodanie procedur składowanych do Projektant O/R.

  • Skonfiguruj klasę Customer tak, aby korzystała z procedur składowanych w celu wykonywania operacji wstawiania, aktualizacji i usuwania.

Wymagania wstępne

W tym przewodniku użyto bazy danych SQL Server Express LocalDB i przykładowej bazy danych Northwind.

  1. Jeśli nie masz bazy danych SQL Server Express LocalDB, zainstaluj ją ze strony pobierania programu SQL Server Express lub za pośrednictwem Instalator programu Visual Studio. W Instalator programu Visual Studio można zainstalować bazę danych SQL Server Express LocalDB w ramach obciążenia Magazynu i przetwarzania danych lub jako pojedynczy składnik.

  2. Zainstaluj przykładową bazę danych Northwind, wykonując następujące kroki:

    1. W programie Visual Studio otwórz okno Eksplorator obiektów programu SQL Server. (Program SQL Server Eksplorator obiektów jest instalowany w ramach obciążenia Magazynu i przetwarzania danych w Instalator programu Visual Studio). Rozwiń węzeł PROGRAMU SQL Server. Kliknij prawym przyciskiem myszy wystąpienie bazy danych LocalDB i wybierz pozycję Nowe zapytanie.

      Zostanie otwarte okno edytora zapytań.

    2. Skopiuj skrypt Northwind Transact-SQL do schowka. Ten skrypt języka T-SQL tworzy bazę danych Northwind od podstaw i wypełnia ją danymi.

    3. Wklej skrypt języka T-SQL do edytora zapytań, a następnie wybierz przycisk Wykonaj .

      Po krótkim czasie zapytanie zakończy działanie i zostanie utworzona baza danych Northwind.

Tworzenie aplikacji i dodawanie linQ do klas SQL

Ponieważ pracujesz z klasami LINQ to SQL i wyświetlasz dane w formularzu systemu Windows, utwórz nową aplikację windows Forms i dodaj plik LINQ to SQL Classes.

Uwaga

Na komputerze mogą być wyświetlane różne nazwy lub lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio w tym artykule. Być może używasz innej wersji programu Visual Studio lub innych ustawień środowiska. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE.

Aby utworzyć nowy projekt aplikacji Windows Forms zawierający klasy LINQ to SQL

  1. W programie Visual Studio w menu Plik wybierz pozycję Nowy>projekt.

  2. Rozwiń węzeł Visual C# lub Visual Basic w okienku po lewej stronie, a następnie wybierz pozycję Pulpit systemu Windows.

  3. W środkowym okienku wybierz typ projektu Aplikacja Windows Forms.

  4. Nadaj projektowi nazwę UpdatingWithSProcsWalkthrough, a następnie wybierz przycisk OK.

    Zostanie utworzony projekt UpdatingWithSProcsWalkthrough i dodany do Eksplorator rozwiązań.

  5. W menu Project (Projekt) kliknij pozycję Add New Item (Dodaj nowy element).

  6. Kliknij szablon LINQ to SQL Classes (Klasy LINQ to SQL) i wpisz Northwind.dbml w polu Nazwa.

  7. Kliknij przycisk Dodaj.

    Do projektu zostanie dodany pusty plik LINQ to SQL Classes (Northwind.dbml), a zostanie otwarty Projektant O/R.

Tworzenie klasy jednostki Customer i źródła danych obiektu

Utwórz klasy LINQ to SQL mapowane na tabele baz danych, przeciągając tabele z Eksploratora serwera lub Eksploratora baz danych do Projektant O/R. Wynikiem są klasy jednostek LINQ to SQL, które mapuje się na tabele w bazie danych. Po utworzeniu klas jednostek mogą być używane jako źródła danych obiektów, podobnie jak inne klasy, które mają właściwości publiczne.

Aby utworzyć klasę jednostki Klient i skonfigurować źródło danych przy użyciu niej

  1. W Eksploratorze serwera lub Eksploratorze bazy danych znajdź tabelę Klient w wersji programu SQL Server przykładowej bazy danych Northwind.

  2. Przeciągnij węzeł Klienci z Eksploratora serwera lub Eksploratora baz danych na powierzchnię *O/R Projektant.

    Zostanie utworzona klasa jednostki o nazwie Klient . Zawiera właściwości odpowiadające kolumnom w tabeli Customers. Klasa jednostek ma nazwę Customer (a nie Customers), ponieważ reprezentuje jednego klienta z tabeli Customers.

    Uwaga

    To zachowanie zmiany nazwy jest nazywane mnogią. Można ją włączyć lub wyłączyć w oknie dialogowym Opcje. Aby uzyskać więcej informacji, zobacz How to: Turn pluralization on and off (O/R Projektant).

  3. W menu Build (Kompilacja) kliknij pozycję Build UpdatingwithSProcsWalkthrough (Kompilowanie aktualizacji za pomocą poleceniaSProcsWalkthrough), aby skompilować projekt.

  4. Aby otworzyć okno Źródła danych, w menu Dane kliknij pozycję Pokaż źródła danych.

  5. W oknie Źródła danych kliknij pozycję Dodaj nowe źródło danych.

  6. Kliknij pozycję Obiekt na stronie Wybierz typ źródła danych, a następnie kliknij przycisk Dalej.

  7. Rozwiń węzeł AktualizowaniewithSProcsWalkthrough i znajdź i wybierz klasę Customer.

    Uwaga

    Jeśli klasa Customer jest niedostępna, anuluj działanie kreatora, skompiluj projekt i uruchom ponownie kreatora.

  8. Kliknij przycisk Zakończ , aby utworzyć źródło danych i dodać klasę jednostki Customer do okna Źródła danych.

Tworzenie elementu DataGridView w celu wyświetlenia danych klienta w formularzu systemu Windows

Utwórz kontrolki powiązane z klasami jednostek, przeciągając elementy źródła danych LINQ to SQL z okna Źródła danych na formularz systemu Windows.

Aby dodać kontrolki powiązane z klasami jednostek

  1. Otwórz formularz Form1 w widoku projektu.

  2. Z okna Źródła danych przeciągnij węzeł Klient do formularza Form1.

    Uwaga

    Aby wyświetlić okno Źródła danych, kliknij pozycję Pokaż źródła danych w menu Dane .

  3. Otwórz plik Form1 w Edytorze kodu.

  4. Dodaj następujący kod do formularza, globalny do formularza, poza dowolną konkretną Form1 metodą, ale wewnątrz klasy:

    private NorthwindDataContext northwindDataContext1
    = new NorthwindDataContext();

  5. Utwórz procedurę obsługi zdarzeń dla Form_Load zdarzenia i dodaj następujący kod do programu obsługi:

    customerBindingSource.DataSource
    = northwindDataContext1.Customers;

Implementowanie funkcji zapisywania

Domyślnie przycisk zapisywania nie jest włączony i funkcja zapisywania nie jest zaimplementowana. Ponadto kod nie jest automatycznie dodawany do zapisywania zmienionych danych w bazie danych po utworzeniu kontrolek powiązanych z danymi dla źródeł danych obiektów. W tej sekcji wyjaśniono, jak włączyć przycisk zapisywania i zaimplementować funkcję zapisywania dla obiektów LINQ to SQL.

Aby zaimplementować funkcję zapisywania

  1. Otwórz formularz Form1 w widoku projektu.

  2. Wybierz przycisk Zapisz na karcie CustomerBindingNavigator (przycisk z ikoną dyskietki).

  3. W oknie Właściwości ustaw właściwość Enabled na True.

  4. Kliknij dwukrotnie przycisk zapisz, aby utworzyć procedurę obsługi zdarzeń i przełączyć się do Edytora kodu.

  5. Dodaj następujący kod do procedury obsługi zdarzeń przycisku zapisywania:

    northwindDataContext1.SubmitChanges();

Zastąpić domyślne zachowanie w przypadku przeprowadzania aktualizacji (wstawiania, aktualizacji i usuwania)

Aby zastąpić domyślne zachowanie aktualizacji

  1. Otwórz plik LINQ to SQL w Projektant O/R. (Kliknij dwukrotnie Plik Northwind.dbml w Eksplorator rozwiązań.

  2. W Eksploratorze serwera lub Eksploratorze bazy danych rozwiń węzeł Procedury składowane bazy danych Northwind i znajdź procedury składowane InsertCustomers, UpdateCustomers i DeleteCustomers.

  3. Przeciągnij wszystkie trzy procedury składowane na Projektant O/R.

    Procedury składowane są dodawane do okienka metody jako DataContext metody. Aby uzyskać więcej informacji, zobacz Metody DataContext (O/R Projektant).

  4. Wybierz klasę jednostki Klient w Projektant O/R.

  5. W oknie Właściwości wybierz właściwość Wstaw.

  6. Kliknij wielokropek (...) obok pozycji Użyj środowiska uruchomieniowego , aby otworzyć okno dialogowe Konfigurowanie zachowania .

  7. Wybierz Dostosuj.

  8. Wybierz metodę InsertCustomers na liście Dostosowywanie .

  9. Kliknij przycisk Zastosuj , aby zapisać konfigurację dla wybranej klasy i zachowania.

    Uwaga

    Możesz nadal konfigurować zachowanie dla każdej kombinacji klasy/zachowania, o ile po wprowadzeniu każdej zmiany klikniesz przycisk Zastosuj . Jeśli zmienisz klasę lub zachowanie przed kliknięciem przycisku Zastosuj, zostanie wyświetlone okno dialogowe ostrzeżenia z możliwością zastosowania wszelkich zmian.

  10. Wybierz pozycję Aktualizuj na liście Zachowanie .

  11. Wybierz Dostosuj.

  12. Wybierz metodę UpdateCustomers na liście Dostosowywanie .

    Sprawdź listę argumentów metody i właściwości klasy i zwróć uwagę, że istnieją dwa argumenty metody i dwie właściwości klasy dla niektórych kolumn w tabeli. Ułatwia to śledzenie zmian i tworzenie instrukcji sprawdzających naruszenia współbieżności.

  13. Zamapuj argument metody Original_CustomerID na właściwość klasy CustomerID (Original).

    Uwaga

    Domyślnie argumenty metody są mapowane na właściwości klasy, gdy nazwy są zgodne. Jeśli nazwy właściwości są zmieniane i nie są już zgodne między tabelą a klasą jednostki, może być konieczne wybranie równoważnej właściwości klasy do mapowania, jeśli Projektant O/R nie może określić poprawnego mapowania. Ponadto jeśli argumenty metody nie mają prawidłowych właściwości klasy do mapowania, możesz ustawić wartość Właściwości klasy na (Brak).

  14. Kliknij przycisk Zastosuj , aby zapisać konfigurację dla wybranej klasy i zachowania.

  15. Wybierz pozycję Usuń na liście Zachowanie .

  16. Wybierz Dostosuj.

  17. Wybierz metodę DeleteCustomers na liście Dostosowywanie .

  18. Zamapuj argument metody Original_CustomerID na właściwość klasy CustomerID (Original).

  19. Kliknij przycisk OK.

Uwaga

Mimo że nie jest to problem z tym konkretnym przewodnikiem, warto zauważyć, że linQ to SQL obsługuje automatycznie wartości generowane przez bazę danych dla tożsamości (automatyczne zwiększanie), rowguidcol (wygenerowany globalnie unikatowy identyfikator (GUID) i kolumny sygnatury czasowej podczas wstawiania i aktualizacji. Wartości wygenerowane przez bazę danych w innych typach kolumn będą nieoczekiwanie skutkować wartością null. Aby zwrócić wartości wygenerowane przez bazę danych, należy ręcznie ustawić IsDbGeneratedtrue wartość i AutoSync na jedną z następujących wartości: AutoSync.Always, AutoSync.OnInsert lub AutoSync.OnUpdate.

Testowanie aplikacji

Uruchom ponownie aplikację, aby sprawdzić, czy procedura składowana UpdateCustomers poprawnie aktualizuje rekord klienta w bazie danych.

  1. Naciśnij klawisz F5.

  2. Zmodyfikuj rekord w siatce, aby przetestować zachowanie aktualizacji.

  3. Dodaj nowy rekord, aby przetestować zachowanie wstawiania.

  4. Kliknij przycisk Zapisz, aby zapisać zmiany z powrotem w bazie danych.

  5. Zamknij formularz.

  6. Naciśnij klawisz F5 i sprawdź, czy zaktualizowany rekord i nowo wstawiony rekord zostały utrwalone.

  7. Usuń nowy rekord utworzony w kroku 3, aby przetestować zachowanie usuwania.

  8. Kliknij przycisk Zapisz, aby przesłać zmiany i usunąć usunięty rekord z bazy danych.

  9. Zamknij formularz.

  10. Naciśnij klawisz F5 i sprawdź, czy usunięty rekord został usunięty z bazy danych.

    Uwaga

    Jeśli aplikacja korzysta z programu SQL Server Express Edition, w zależności od wartości właściwości Copy to Output Directory pliku bazy danych, zmiany mogą nie być wyświetlane po naciśnięciu klawisza F5 w kroku 10.

Następne kroki

W zależności od wymagań aplikacji istnieje kilka kroków, które można wykonać po utworzeniu klas jednostek LINQ to SQL. Niektóre ulepszenia, które można wprowadzić w tej aplikacji, obejmują następujące elementy:

Powiązana zawartość