Wiązanie obiektów jako źródeł danych w aplikacjach .NET Framework przy użyciu programu Visual Studio

Program Visual Studio udostępnia narzędzia projektowania do pracy z obiektami niestandardowymi jako źródłem danych w aplikacji. Jeśli chcesz przechowywać dane z bazy danych w obiekcie powiązanym z kontrolkami interfejsu użytkownika, zalecane jest użycie programu Entity Framework do generowania klas lub klas. Program Entity Framework automatycznie generuje cały standardowy kod śledzenia zmian, co oznacza, że wszelkie zmiany obiektów lokalnych są automatycznie utrwalane w bazie danych po wywołaniu metody AcceptChanges w obiekcie DbSet. Aby uzyskać więcej informacji, zobacz Dokumentację programu Entity Framework.

Wymagania dotyczące obiektu

Jedynym wymaganiem dla obiektów niestandardowych do pracy z narzędziami projektowania danych w programie Visual Studio jest to, że obiekt potrzebuje co najmniej jednej właściwości publicznej.

Ogólnie rzecz biorąc, obiekty niestandardowe nie wymagają żadnych określonych interfejsów, konstruktorów ani atrybutów do działania jako źródła danych dla aplikacji. Jeśli jednak chcesz przeciągnąć obiekt z okna Źródła danych do powierzchni projektowej w celu utworzenia kontrolki powiązanej z danymi, a jeśli obiekt implementuje ITypedList interfejs lub IListSource , obiekt musi mieć konstruktor domyślny. W przeciwnym razie program Visual Studio nie może zainicjować wystąpienia obiektu źródła danych i wyświetla błąd podczas przeciągnięcia elementu na powierzchnię projektową.

Przykłady użycia obiektów niestandardowych jako źródeł danych

Chociaż istnieje wiele sposobów implementowania logiki aplikacji podczas pracy z obiektami jako źródłem danych, w przypadku baz danych SQL istnieje kilka standardowych operacji, które można uprościć przy użyciu obiektów TableAdapter wygenerowanych przez program Visual Studio. Na tej stronie wyjaśniono, jak zaimplementować te standardowe procesy przy użyciu elementów TableAdapters. Nie jest ona przeznaczona jako przewodnik tworzenia obiektów niestandardowych. Na przykład zwykle wykonujesz następujące standardowe operacje niezależnie od konkretnej implementacji obiektów lub logiki aplikacji:

• Ładowanie danych do obiektów (zazwyczaj z bazy danych).

• Tworzenie kolekcji obiektów typu.

• Dodawanie obiektów do kolekcji i usuwanie ich z kolekcji.

• Wyświetlanie danych obiektu użytkownikom w formularzu.

• Zmiana/edytowanie danych w obiekcie.

• Zapisywanie danych z obiektów z powrotem do bazy danych.

Ładowanie danych do obiektów

W tym przykładzie dane są ładowane do obiektów przy użyciu TableAdapterów. Domyślnie klasy TableAdapters są tworzone przy użyciu dwóch rodzajów metod, które pobierają dane z bazy danych i wypełniają tabele danych.

• Metoda TableAdapter.Fill wypełnia istniejącą tabelę danych zwróconymi danymi.

• Metoda TableAdapter.GetData zwraca nową tabelę danych wypełniną danymi.

Najprostszym sposobem załadowania obiektów niestandardowych przy użyciu danych jest wywołanie metody TableAdapter.GetData, przejście pętlą przez kolekcję wierszy w zwracanej tabeli danych i wypełnienie każdego obiektu wartościami z każdego wiersza. Możesz utworzyć metodę zwracającą wypełniona tabelę GetData danych dla dowolnego zapytania dodanego do tabeli TableAdapter.

W poniższym przykładzie pokazano, jak iterować przez wiersze w tabeli danych i wypełniać obiekt danymi.

private void LoadCustomers()
{
    NorthwindDataSet.CustomersDataTable customerData = 
        customersTableAdapter1.GetTop5Customers();
    
    foreach (NorthwindDataSet.CustomersRow customerRow in customerData)
    {
        Customer currentCustomer = new Customer();
        currentCustomer.CustomerID = customerRow.CustomerID;
        currentCustomer.CompanyName = customerRow.CompanyName;

        if (customerRow.IsAddressNull() == false)
        {
            currentCustomer.Address = customerRow.Address;
        }

        if (customerRow.IsCityNull() == false)
        {
            currentCustomer.City = customerRow.City;
        }

        if (customerRow.IsContactNameNull() == false)
        {
            currentCustomer.ContactName = customerRow.ContactName;
        }

        if (customerRow.IsContactTitleNull() == false)
        {
            currentCustomer.ContactTitle = customerRow.ContactTitle;
        }

        if (customerRow.IsCountryNull() == false)
        {
            currentCustomer.Country = customerRow.Country;
        }

        if (customerRow.IsFaxNull() == false)
        {
            currentCustomer.Fax = customerRow.Fax;
        }

        if (customerRow.IsPhoneNull() == false)
        {
            currentCustomer.Phone = customerRow.Phone;
        }

        if (customerRow.IsPostalCodeNull() == false)
        {
            currentCustomer.PostalCode = customerRow.PostalCode;
        }

        if (customerRow.IsRegionNull() == false)
        {
            currentCustomer.Region = customerRow.Region;
        }

        LoadOrders(currentCustomer);
        customerBindingSource.Add(currentCustomer);
    }
}

Private Sub LoadCustomers()
    Dim customerData As NorthwindDataSet.CustomersDataTable =
        CustomersTableAdapter1.GetTop5Customers()

    Dim customerRow As NorthwindDataSet.CustomersRow

    For Each customerRow In customerData
        Dim currentCustomer As New Customer()
        With currentCustomer

            .CustomerID = customerRow.CustomerID
            .CompanyName = customerRow.CompanyName

            If Not customerRow.IsAddressNull Then
                .Address = customerRow.Address
            End If

            If Not customerRow.IsCityNull Then
                .City = customerRow.City
            End If

            If Not customerRow.IsContactNameNull Then
                .ContactName = customerRow.ContactName
            End If

            If Not customerRow.IsContactTitleNull Then
                .ContactTitle = customerRow.ContactTitle
            End If

            If Not customerRow.IsCountryNull Then
                .Country = customerRow.Country
            End If

            If Not customerRow.IsFaxNull Then
                .Fax = customerRow.Fax
            End If

            If Not customerRow.IsPhoneNull Then
                .Phone = customerRow.Phone
            End If

            If Not customerRow.IsPostalCodeNull Then
                .PostalCode = customerRow.PostalCode
            End If

            If Not customerRow.Is_RegionNull Then
                .Region = customerRow._Region
            End If

        End With

        LoadOrders(currentCustomer)
        CustomerBindingSource.Add(currentCustomer)
    Next
End Sub

Utwórz typizowaną kolekcję obiektów

Można tworzyć klasy kolekcji dla obiektów lub używać typowanych kolekcji, które są automatycznie udostępniane przez składnik BindingSource.

Podczas tworzenia niestandardowej klasy kolekcji dla obiektów sugerujemy dziedziczenie z BindingList<T> klasy. Ta klasa ogólna udostępnia funkcje administrowania kolekcją, a także możliwość zgłaszania zdarzeń, które wysyłają powiadomienia do infrastruktury powiązania danych w formularzach Windows Forms.

Automatycznie wygenerowana kolekcja w BindingSource używa BindingList<T> dla swojej typizowanej kolekcji. Jeśli aplikacja nie wymaga dodatkowych funkcji, możesz zachować kolekcję w programie BindingSource. Aby uzyskać więcej informacji, zajrzyj do właściwości List klasy BindingSource.

Poniższy kod pokazuje, jak utworzyć klasę dla silnie typizowanej Order kolekcji obiektów:

/// <summary>
/// A collection of Orders
/// </summary>
public class Orders: System.ComponentModel.BindingList<Order>
{
    // Add any additional functionality required by your collection.
}

''' <summary>
''' A collection of Orders
''' </summary>
Public Class Orders
    Inherits System.ComponentModel.BindingList(Of Order)

    ' Add any additional functionality required by your collection.

End Class

Dodawanie obiektów do kolekcji

Dodajesz obiekty do kolekcji, wywołując metodę Add swojej niestandardowej klasy kolekcji lub klasy BindingSource.

Poniższy kod pokazuje, jak dodać obiekty do typizowanej kolekcji w BindingSource.

Customer currentCustomer = new Customer();
customerBindingSource.Add(currentCustomer);

Dim currentCustomer As New Customer()
CustomerBindingSource.Add(currentCustomer)

Poniższy kod pokazuje, jak dodać obiekty do kolekcji typizowanej, która dziedziczy z klasy BindingList<T>.

Order currentOrder = new Order();
currentCustomer.Orders.Add(currentOrder);

Dim currentOrder As New Order()
currentCustomer.Orders.Add(currentOrder)

Usuwanie obiektów z kolekcji

Obiekty usuwa się z kolekcji, wywołując metodę Remove lub RemoveAt w twojej klasie kolekcji niestandardowej lub BindingSource klasie.

Poniższy kod pokazuje, jak zlokalizować i usunąć obiekty z typizowanej kolekcji w BindingSource za pomocą metody RemoveAt:

int customerIndex = customerBindingSource.Find("CustomerID", "ALFKI");
customerBindingSource.RemoveAt(customerIndex);

Dim customerIndex As Integer = CustomerBindingSource.Find("CustomerID", "ALFKI")
CustomerBindingSource.RemoveAt(customerIndex)

Wyświetlanie danych obiektów dla użytkowników

Aby wyświetlić dane w obiektach dla użytkowników, utwórz źródło danych obiektu za pomocą kreatora Konfiguracja źródła danych , a następnie przeciągnij cały obiekt lub poszczególne właściwości do formularza z okna Źródła danych .

Modyfikowanie danych w obiektach

Aby edytować dane w obiektach niestandardowych powiązanych z kontrolkami formularzy systemu Windows, po prostu edytuj dane w powiązanej kontrolce (lub bezpośrednio we właściwościach obiektu). Architektura powiązania danych aktualizuje dane w obiekcie.

Jeśli aplikacja wymaga śledzenia zmian i wycofywania proponowanych zmian w ich oryginalnych wartościach, musisz zaimplementować tę funkcję w modelu obiektów. Przykłady sposobu śledzenia proponowanych zmian w tabelach danych można znaleźć w temacie DataRowState, HasChangesi GetChanges.

Zapisywanie danych w obiektach z powrotem do bazy danych

Zapisz dane do bazy danych, przekazując wartości z obiektu do metod DBDirect TableAdaptera.

Program Visual Studio tworzy metody DBDirect, które można wykonywać bezpośrednio w bazie danych. Te metody nie wymagają obiektów DataSet ani DataTable.

Aby zapisać dane z kolekcji obiektów, wykonaj pętlę przez kolekcję obiektów (na przykład przy użyciu pętli for-next). Wyślij wartości dla każdego obiektu do bazy danych przy użyciu metod DBDirect usługi TableAdapter.

W poniższym przykładzie pokazano, jak za pomocą TableAdapter.Insert metody DBDirect dodać nowego klienta bezpośrednio do bazy danych:

private void AddNewCustomers(Customer currentCustomer)
{
    customersTableAdapter.Insert( 
        currentCustomer.CustomerID, 
        currentCustomer.CompanyName, 
        currentCustomer.ContactName, 
        currentCustomer.ContactTitle, 
        currentCustomer.Address, 
        currentCustomer.City, 
        currentCustomer.Region, 
        currentCustomer.PostalCode, 
        currentCustomer.Country, 
        currentCustomer.Phone, 
        currentCustomer.Fax);
}

Private Sub AddNewCustomer(ByVal currentCustomer As Customer)

    CustomersTableAdapter.Insert(
        currentCustomer.CustomerID,
        currentCustomer.CompanyName,
        currentCustomer.ContactName,
        currentCustomer.ContactTitle,
        currentCustomer.Address,
        currentCustomer.City,
        currentCustomer.Region,
        currentCustomer.PostalCode,
        currentCustomer.Country,
        currentCustomer.Phone,
        currentCustomer.Fax)
End Sub

Treści powiązane

• wiązanie kontrolek z danymi w programie Visual Studio