Wykonywanie zadań związanych z danymi przy użyciu kodu

Na poniższej liście pokazano niektóre typowe powiązane dane zadań wykonywanych przy użyciu modelu obiektowego uruchamiania danych. Zadania są opisane w dalszej części tego dokumentu.

• Odczyt danych

• Aktualizowanie danych

• Usuwanie danych

• Dodawanie danych

• Zapisywanie danych

• Sprawdzanie poprawności danych

• Ustawianie uprawnień dla danych

• Praca z zestawami zmian

• Rozszerzanie zapytań

Można czytać pojedyncze elementy danych lub kolekcje elementów danych z dowolnego źródła danych w aplikacji.

Poniższy przykład pobiera klienta, który jest aktualnie zaznaczony na ekranie.

partial void RetrieveCustomer_Execute()
{
    Customer cust = this.Customers.SelectedItem;
    if (cust.ContactName == "Bob")
    {
        //Perform some task on the customer entity.
    }
}

Poniższy przykład wykonuje iterację na zbiorze klientów.

partial void RetrieveCustomers_Execute()
{
    foreach (Customer cust in this.DataWorkspace.NorthwindData.Customers)
    {
        if (cust.ContactName == "Bob")
        {
            //Perform some task on the customer entity.
        }
    }
}

Nawigacja po relacjach danych

partial void RetrieveSalesOrders_Execute()
{
    Customer cust = this.Customers.SelectedItem;

    foreach (Order order in cust.Orders)
    {
        if (order.OrderDate == DateTime.Today)
        {
            //perform some task on the order entity.
        }
    }
}

partial void RetrieveCustomer_Execute()
{
    Order order = this.DataWorkspace.NorthwindData.Orders_Single
        (Orders.SelectedItem.OrderID);

    Customer cust = order.Customer;
    //Perform some task on the customer entity.

}

Odczytywanie danych przez wykonywanie zapytania

Można zaktualizować dane dla dowolnej jednostki przy użyciu kodu. W poniższym przykładzie przedstawiono kod, który jest uruchamiany, gdy użytkownik utworzy zamówienie w jednostce zamówienia na ekranie, a następnie kliknie przycisk Zapisz. Kod aktualizuje pole w jednostce Produkty za pomocą pola w jednostce Szczegóły zamówienia.

partial void Orders_Inserting(Order entity)
{
    foreach (Order_Detail detail in entity.Order_Details)
    {
        detail.Product.UnitsInStock = 
            (short?)(detail.Product.UnitsInStock - detail.Quantity);
    }
}

Uwaga
Jeżeli kod modyfikuje dane z innego źródła danych, musisz zatwierdzić te zmiany przez wywołanie metody SaveChanges tego źródła danych. Aby uzyskać więcej informacji zobacz How to: Save Data.

Można usunąć dane, wywołując metodę Delete jednostki. Poniższy przykład usuwa klienta ze źródła danych NorthwindData.

partial void DeleteCustomer_Execute()
{
    Customer cust =
        this.Customers.SelectedItem;

    if (Customers.CanDelete)
    {
        cust.Delete();
    }
}

Poniższy przykład dodaje nowego klienta do źródła danych NorthwindData. W tym przykładzie wypełniono pola, które opisują nowego klienta przy użyciu informacji z kontaktu, który niedawno został dodany do listy programu SharePoint. Przykład wywołuje zapytanie o nazwie NewCustomersInSharePoint w celu określenia, które kontakty na liście programu SharePoint nie zostały jeszcze zaimportowane do źródła danych NorthwindData.

partial void ImportCustomers_Execute()
{
    foreach (SharePointCustomer spCust in
this.DataWorkspace.SharePointData.NewCustomersInSharePoint())
    {
        Customer newCust = new Customer();

        newCust.ContactName = spCust.FirstName + " " + spCust.LastName;
        newCust.Address = spCust.Address;
        newCust.City = spCust.City;
        newCust.PostalCode = spCust.PostalCode;
        newCust.Region = spCust.Region;

        //Set the CopiedToDatabase field of the item in SharePoint.
        spCust.CopiedToDatabase = "Yes";
    }
    this.DataWorkspace.SharePointData.SaveChanges();


}

Zazwyczaj oczekujące zmiany są zatwierdzane do źródła danych, gdy użytkownik kliknie przycisk Zapisz na ekranie. Jednakże można także zatwierdzić oczekujące zmiany przez dodanie kodu wywołującego metodę SaveChanges źródła danych. Jeśli chcesz wykonać którekolwiek z tych zadań, musisz dodać ten kod:

• Zatwierdź zmiany wprowadzone w danych znajdujących się w innych źródłach danych.

• Zastąp zdarzenie Save ekranu.

Zatwierdzanie zmian wprowadzonych w danych znajdujących się w innych źródłach danych.

partial void Orders_Inserting(Order1 entity)
{
    foreach (Order_Detail1 detail in entity.Order_Details)
    {
        detail.Product.UnitsInStock = (short?)
            (detail.Product.UnitsInStock - detail.Quantity);
    }
    this.DataWorkspace.ProductDataSource.SaveChanges();

}

Zastępowanie zdarzenie zapisywania ekranu.

partial void CustomersListDetail_Saving(ref bool handled)
{
    try
    {
        this.DataWorkspace.SharePointData.SaveChanges();
    }
    catch (DataServiceOperationException ex)
    {
        if (ex.ErrorInfo == "DTSException")
        {
            this.ShowMessageBox(ex.Message);
        }
        else
        {
            throw ex;
        }
    }
    handled = true;


}

Można zastosować reguły sprawdzania poprawności w niestandardowych polach jednostki. Można dodawać niestandardowe komunikaty o błędach wyświetlane, gdy użytkownicy zmodyfikują wartości właściwości w sposób, który nie jest zgodny z regułami sprawdzania poprawności. Aby uzyskać więcej informacji zobacz Jak: Sprawdzić poprawność danych

Domyślnie wszyscy użytkownicy mogą wyświetlać, wstawiać, usuwać lub aktualizować dane wyświetlane na ekranie. Może jednak ograniczyć te uprawnienia, dodając kod do jednej z następujących metod:

• CanRead

• CanInsert

• CanDelete

• CanUpdate

Jeśli ograniczysz operację przy użyciu tych metod, LightSwitch powoduje, że operacja jest niedostępna dla użytkowników, którzy nie mają nieograniczonych uprawnień. Aby uzyskać więcej informacji zobacz Jak: Obsłużyć zdarzenia powiązane z danymi.

Poniższy przykład pozwala użytkownikowi na aktualizowanie informacji o kliencie, jeśli użytkownik ma uprawnienia do aktualizacji. Poniższy przykład kodu wymaga grupy uprawnień o nazwie RoleUpdate. Aby uzyskać więcej informacji na temat dodawania grup zezwoleń do aplikacji, zobacz Włączenie autoryzacji i uprawnień tworzenia.

partial void Customers_CanUpdate(ref bool result)
{
    this.Application.User.HasPermission(Permissions.RoleUpdate);
}

Domyślnie LightSwitch wywołuje te metody, gdy użytkownik próbuje wyświetlić, wstawić, usunąć lub zaktualizować informacje. Metody te można również wywołać w niestandardowym kodzie przed odczytem lub modyfikacją danych.

Można zidentyfikować i odrzucić zmiany oczekujące, zanim zostaną zatwierdzone dla źródła danych. Poniższy przykład przedstawia trzy metody pomocnika, które identyfikują i odrzucają oczekujące zmiany. Metoda UndoAllCustomerUpdates odrzuca wszystkie zmiany wprowadzone do wszystkich klientów. Metoda UndoAllUpdates odrzuca wszystkie zmiany wprowadzone do źródła danych. Metoda UndoCustomerEdit odrzuca zmiany wprowadzone w aktualnie zaznaczonym wierszu danych na ekranie klienta.

partial void UndoAllCustomerUpdates_Execute()
{
    foreach (Customer cust in 
        this.DataWorkspace.NorthwindData.Details.
        GetChanges().OfType<Customer>())
    {
        cust.Details.DiscardChanges();
    }
}

partial void UndoAllUpdates_Execute()
{
    this.DataWorkspace.NorthwindData.Details.DiscardChanges();
}

partial void UndoCustomerEdit_Execute()
{
    Customers.SelectedItem.Details.DiscardChanges();
}

Jeśli chcesz zmodyfikować zapytanie poza możliwościami projektanta zapytań, możesz rozszerzyć zapytania przez dodanie kodu do metody PreProcessQuery zapytania. Aby uzyskać więcej informacji zobacz Jak: Rozszerzyć zapytanie przy użyciu kodu.

Inne zasoby