Obsługa wyjątków na poziomie warstwy logiki biznesowej i warstwy dostępu do danych (VB)

Artykuł
08/10/2024

W tym samouczku zobaczymy, jak tactfully obsługiwać wyjątki zgłaszane podczas edytowalnego przepływu pracy aktualizacji elementu DataList.

Wprowadzenie

W samouczku Omówienie edytowania i usuwania danych w usłudze DataList utworzyliśmy element DataList , który oferował proste funkcje edytowania i usuwania. Chociaż w pełni funkcjonalny, nie był przyjazny dla użytkownika, ponieważ wszelkie błędy, które wystąpiły podczas procesu edytowania lub usuwania, spowodowały nieobsługiwany wyjątek. Na przykład pominięcie nazwy produktu lub, podczas edytowania produktu, wprowadzenie wartości ceny bardzo przystępnej!, zgłasza wyjątek. Ponieważ ten wyjątek nie jest przechwytywane w kodzie, bąbelki do środowiska uruchomieniowego ASP.NET, które następnie wyświetla szczegóły wyjątku na stronie internetowej.

Jak pokazano w samouczku Obsługa wyjątków na poziomie BLL i DAL w samouczku dotyczącym strony ASP.NET, jeśli zostanie zgłoszony wyjątek z głębi warstwy logiki biznesowej lub dostępu do danych, szczegóły wyjątku są zwracane do obiektu ObjectDataSource, a następnie do kontrolki GridView. Zobaczyliśmy, jak bezpiecznie obsługiwać te wyjątki, tworząc Updated programy obsługi zdarzeń dla RowUpdated obiektu ObjectDataSource lub GridView, sprawdzając wyjątek, a następnie wskazując, że wyjątek został obsłużony.

Nasze samouczki DataList nie używają jednak obiektu ObjectDataSource do aktualizowania i usuwania danych. Zamiast tego pracujemy bezpośrednio przeciwko BLL. Aby wykryć wyjątki pochodzące z biblioteki BLL lub DAL, musimy zaimplementować kod obsługi wyjątków w kodzie naszej strony ASP.NET. W tym samouczku zobaczymy, jak bardziej tactfully obsługiwać wyjątki zgłaszane podczas edytowalnego przepływu pracy aktualizacji elementu DataList.

Uwaga

W samouczku Omówienie edytowania i usuwania danych w usłudze DataList omówiliśmy różne techniki edytowania i usuwania danych z listy DataList , niektóre techniki związane z używaniem obiektu ObjectDataSource do aktualizowania i usuwania. Jeśli zastosujesz te techniki, możesz obsługiwać wyjątki z biblioteki BLL lub DAL za pośrednictwem programów obsługi zdarzeń lub Deleted obiektów ObjectDataSourceUpdated.

Krok 1. Tworzenie edytowalnej listy danych

Zanim martwimy się o obsługę wyjątków występujących podczas aktualizowania przepływu pracy, najpierw utwórzmy edytowalną listę danych. ErrorHandling.aspx Otwórz stronę w folderzeEditDeleteDataList, dodaj element DataList do projektanta, ustaw jego ID właściwość na Products, a następnie dodaj nową właściwość ObjectDataSource o nazwie ProductsDataSource. Skonfiguruj obiekt ObjectDataSource do używania ProductsBLL metody klasy s GetProducts() do wybierania rekordów; ustaw listy rozwijane na kartach INSERT, UPDATE i DELETE na wartość (Brak).

Rysunek 1. Zwracanie informacji o produkcie GetProducts() przy użyciu metody (kliknij, aby wyświetlić obraz o pełnym rozmiarze)

Po ukończeniu pracy kreatora ObjectDataSource program Visual Studio automatycznie utworzy obiekt ItemTemplate dla elementu DataList. Zastąp element wartością ItemTemplate , która wyświetla nazwę i cenę każdego produktu oraz zawiera przycisk Edytuj. Następnie utwórz element EditItemTemplate z kontrolką internetową TextBox dla nazw i cen oraz przycisków Aktualizuj i Anuluj. Na koniec ustaw właściwość DataList RepeatColumns na 2.

Po tych zmianach znaczniki deklaratywne strony powinny wyglądać podobnie do poniższego. Sprawdź dwukrotnie, aby upewnić się, że przyciski Edytuj, Anuluj i Aktualizuj mają właściwości CommandName ustawione odpowiednio na Edytuj, Anuluj i Aktualizuj.

<asp:DataList ID="Products" runat="server" DataKeyField="ProductID"
    DataSourceID="ProductsDataSource" RepeatColumns="2">
    <ItemTemplate>
        <h5>
            <asp:Label runat="server" ID="ProductNameLabel"
                Text='<%# Eval("ProductName") %>' />
        </h5>
        Price:
            <asp:Label runat="server" ID="Label1"
                Text='<%# Eval("UnitPrice", "{0:C}") %>' />
        <br />
            <asp:Button runat="server" id="EditProduct" CommandName="Edit"
                Text="Edit" />
        <br />
        <br />
    </ItemTemplate>
    <EditItemTemplate>
        Product name:
            <asp:TextBox ID="ProductName" runat="server"
                Text='<%# Eval("ProductName") %>' />
        <br />
        Price:
            <asp:TextBox ID="UnitPrice" runat="server"
                Text='<%# Eval("UnitPrice", "{0:C}") %>' />
        <br />
        <br />
            <asp:Button ID="UpdateProduct" runat="server" CommandName="Update"
                Text="Update" /> 
            <asp:Button ID="CancelUpdate" runat="server" CommandName="Cancel"
                Text="Cancel" />
    </EditItemTemplate>
</asp:DataList>
<asp:ObjectDataSource ID="ProductsDataSource" runat="server"
    SelectMethod="GetProducts" TypeName="ProductsBLL"
    OldValuesParameterFormatString="original_{0}">
</asp:ObjectDataSource>

Uwaga

Na potrzeby tego samouczka należy włączyć stan widoku DataList.

Pośmiń chwilę, aby wyświetlić postęp w przeglądarce (zobacz Rysunek 2).

Rysunek 2. Każdy produkt zawiera przycisk edycji (kliknij, aby wyświetlić obraz o pełnym rozmiarze)

Obecnie przycisk Edytuj powoduje tylko powrót po awarii, ale nie powoduje jeszcze edycji produktu. Aby włączyć edycję, musimy utworzyć programy obsługi zdarzeń dla zdarzeń DataList s EditCommand, CancelCommandi UpdateCommand . Zdarzenia EditCommand i CancelCommand po prostu aktualizują właściwość DataList i EditItemIndex ponownie połąkają dane do elementu DataList:

Protected Sub Products_EditCommand(source As Object, e As DataListCommandEventArgs) _
    Handles Products.EditCommand
    ' Set the DataList's EditItemIndex property to the
    ' index of the DataListItem that was clicked
    Products.EditItemIndex = e.Item.ItemIndex
    ' Rebind the data to the DataList
    Products.DataBind()
End Sub
Protected Sub Products_CancelCommand(source As Object, e As DataListCommandEventArgs) _
    Handles Products.CancelCommand
    ' Set the DataList's EditItemIndex property to -1
    Products.EditItemIndex = -1
    ' Rebind the data to the DataList
    Products.DataBind()
End Sub

Procedura UpdateCommand obsługi zdarzeń jest nieco bardziej zaangażowana. Należy odczytać w edytowanych produktach ProductID z DataKeys kolekcji wraz z nazwą i ceną produktu z pola TextBoxes w EditItemTemplatepliku , a następnie wywołać ProductsBLL metodę klasy s UpdateProduct przed zwróceniem elementu DataList do stanu wstępnego edycji.

Na razie użyjemy dokładnie tego samego kodu z UpdateCommand programu obsługi zdarzeń w samouczku Omówienie edytowania i usuwania danych w samouczku DataList . Dodamy kod, aby bezpiecznie obsługiwać wyjątki w kroku 2.

Protected Sub Products_UpdateCommand(source As Object, e As DataListCommandEventArgs) _
    Handles Products.UpdateCommand
    ' Read in the ProductID from the DataKeys collection
    Dim productID As Integer = Convert.ToInt32(Products.DataKeys(e.Item.ItemIndex))
    ' Read in the product name and price values
    Dim productName As TextBox = CType(e.Item.FindControl("ProductName"), TextBox)
    Dim unitPrice As TextBox = CType(e.Item.FindControl("UnitPrice"), TextBox)
    Dim productNameValue As String = Nothing
    If productName.Text.Trim().Length > 0 Then
        productNameValue = productName.Text.Trim()
    End If
    Dim unitPriceValue As Nullable(Of Decimal) = Nothing
    If unitPrice.Text.Trim().Length > 0 Then
        unitPriceValue = Decimal.Parse(unitPrice.Text.Trim(), _
                         System.Globalization.NumberStyles.Currency)
    End If
    ' Call the ProductsBLL's UpdateProduct method...
    Dim productsAPI As New ProductsBLL()
    productsAPI.UpdateProduct(productNameValue, unitPriceValue, productID)
    ' Revert the DataList back to its pre-editing state
    Products.EditItemIndex = -1
    Products.DataBind()
End Sub

W obliczu nieprawidłowych danych wejściowych, które mogą być w postaci nieprawidłowo sformatowanej ceny jednostkowej, zostanie podniesiona nieprawidłowa wartość ceny jednostkowej, na przykład -$5,00 lub pominięcie nazwy produktu. Ponieważ program UpdateCommand obsługi zdarzeń nie zawiera w tym momencie żadnego kodu obsługi wyjątków, wyjątek będzie bąbelkować do środowiska uruchomieniowego ASP.NET, gdzie będzie on wyświetlany użytkownikowi końcowemu (zobacz Rysunek 3).

Gdy wystąpi nieobsługiwany wyjątek, użytkownik końcowy zobaczy stronę błędu

Rysunek 3. Gdy wystąpi nieobsługiwany wyjątek, użytkownik końcowy zobaczy stronę błędu

Krok 2. Bezproblemowa obsługa wyjątków w procedurze obsługi zdarzeń UpdateCommand

Podczas aktualizowania przepływu pracy wyjątki mogą wystąpić w UpdateCommand procedurze obsługi zdarzeń, BLL lub DAL. Jeśli na przykład użytkownik wprowadzi cenę zbyt kosztowną, Decimal.Parse instrukcja w UpdateCommand procedurze obsługi zdarzeń zgłosi FormatException wyjątek. Jeśli użytkownik pomija nazwę produktu lub jeśli cena ma wartość ujemną, dal zgłosi wyjątek.

Gdy wystąpi wyjątek, chcemy wyświetlić komunikat informacyjny w obrębie samej strony. Dodaj kontrolkę Etykieta sieci Web do strony, której ID ustawiono wartość ExceptionDetails. Skonfiguruj tekst Etykiety tak, aby był wyświetlany w kolorze czerwonym, bardzo dużym, pogrubionym i kursywą, przypisując jego CssClass właściwość do Warning klasy CSS zdefiniowanej Styles.css w pliku.

Gdy wystąpi błąd, chcemy, aby etykieta będzie wyświetlana tylko raz. Oznacza to, że po kolejnych powrotach komunikat ostrzegawczy Etykieta powinien zniknąć. Można to osiągnąć przez wyczyszczenie właściwości Etykieta Text lub jej Visible właściwości do False w Page_Load programie obsługi zdarzeń (tak jak w przypadku obsługi wyjątków na poziomie BLL i DAL w samouczku dotyczącym strony ASP.NET) lub przez wyłączenie obsługi stanu widoku etykiety. Użyjmy tej drugiej opcji.

<asp:Label ID="ExceptionDetails" EnableViewState="False" CssClass="Warning"
    runat="server" />

Po wystąpieniu wyjątku przypiszemy szczegóły wyjątku do ExceptionDetails właściwości kontrolki Etykieta Text . Ponieważ jego stan widoku jest wyłączony, po kolejnych ogłaszaniu Text zwrotnym zmiany programowe właściwości zostaną utracone, przywracając domyślny tekst (pusty ciąg), ukrywając w ten sposób komunikat ostrzegawczy.

Aby określić, kiedy został zgłoszony błąd, aby wyświetlić pomocny komunikat na stronie, musimy dodać Try ... Catch blok do UpdateCommand procedury obsługi zdarzeń. Część Try zawiera kod, który może prowadzić do wyjątku, podczas gdy Catch blok zawiera kod wykonywany w obliczu wyjątku. Zapoznaj się z sekcją Podstawy obsługi wyjątków w dokumentacji programu .NET Framework, aby uzyskać więcej informacji na Try ... Catch temat bloku.

Protected Sub Products_UpdateCommand(source As Object, e As DataListCommandEventArgs) _
    Handles Products.UpdateCommand
    ' Handle any exceptions raised during the editing process
    Try
        ' Read in the ProductID from the DataKeys collection
        Dim productID As Integer = _
            Convert.ToInt32(Products.DataKeys(e.Item.ItemIndex))
        ... Some code omitted for brevity ...
    Catch ex As Exception
        ' TODO: Display information about the exception in ExceptionDetails
    End Try
End Sub

Gdy wyjątek dowolnego typu jest zgłaszany przez kod w Try bloku, Catch kod bloku rozpocznie wykonywanie. Typ wyjątku, który jest zgłaszany DbException, NoNullAllowedException, ArgumentExceptioni tak dalej zależy od tego, co dokładnie, wytrącił błąd w pierwszej kolejności. Jeśli wystąpi problem na poziomie bazy danych, zostanie zgłoszony błąd DbException . Jeśli dla pól , , , lub zostanie wprowadzona UnitPriceniedozwolona wartość, zostanie ArgumentException zgłoszony kod, ponieważ dodaliśmy kod w celu zweryfikowania tych wartości pól w ProductsDataTable klasie (zobacz samouczek Tworzenie warstwy logiki biznesowej).ReorderLevel UnitsOnOrderUnitsInStock

Możemy podać bardziej przydatne wyjaśnienie dla użytkownika końcowego, opierając tekst komunikatu na typie przechwyconego wyjątku. Poniższy kod, który został użyty w niemal identycznym formularzu w samouczku Obsługa wyjątków BLL i DAL na poziomie ASP.NET, zawiera ten poziom szczegółów:

Private Sub DisplayExceptionDetails(ByVal ex As Exception)
    ' Display a user-friendly message
    ExceptionDetails.Text = "There was a problem updating the product. "
    If TypeOf ex Is System.Data.Common.DbException Then
        ExceptionDetails.Text += "Our database is currently experiencing problems." + _
                                 "Please try again later."
    ElseIf TypeOf ex Is System.Data.NoNullAllowedException Then
        ExceptionDetails.Text+="There are one or more required fields that are missing."
    ElseIf TypeOf ex Is ArgumentException Then
        Dim paramName As String = CType(ex, ArgumentException).ParamName
        ExceptionDetails.Text+=String.Concat("The ", paramName, " value is illegal.")
    ElseIf TypeOf ex Is ApplicationException Then
        ExceptionDetails.Text += ex.Message
    End If
End Sub

Aby ukończyć ten samouczek, po prostu wywołaj metodę DisplayExceptionDetails z Catch bloku przekazującego wystąpienie przechwycone Exception (ex).

Po utworzeniu Try ... Catch bloku użytkownicy otrzymują bardziej informacyjny komunikat o błędzie, jak pokazano na rysunkach 4 i 5. Należy pamiętać, że w obliczu wyjątku lista Danych Pozostaje w trybie edycji. Jest to spowodowane tym, że po wystąpieniu wyjątku przepływ sterowania jest natychmiast przekierowywany do Catch bloku, przekazując kod, który zwraca element DataList do stanu wstępnego edytowania.

Rysunek 4. Komunikat o błędzie jest wyświetlany, jeśli użytkownik pomija wymagane pole (kliknij, aby wyświetlić obraz pełnowymiarowy)

Rysunek 5. Podczas wprowadzania ceny ujemnej jest wyświetlany komunikat o błędzie (kliknij, aby wyświetlić obraz o pełnym rozmiarze)

Podsumowanie

Kontrolki GridView i ObjectDataSource udostępniają programy obsługi zdarzeń po poziomie, które zawierają informacje o wszelkich wyjątkach zgłoszonych podczas aktualizowania i usuwania przepływu pracy, a także właściwości, które można ustawić, aby wskazać, czy wyjątek został obsłużony. Te funkcje są jednak niedostępne podczas pracy z elementem DataList i bezpośrednio przy użyciu biblioteki BLL. Zamiast tego jesteśmy odpowiedzialni za implementację obsługi wyjątków.

W tym samouczku pokazano, jak dodać obsługę wyjątków do edytowalnego przepływu pracy aktualizacji elementu DataList przez dodanie Try ... Catch bloku do UpdateCommand programu obsługi zdarzeń. Jeśli podczas aktualizowania przepływu pracy zostanie zgłoszony wyjątek, Catch kod bloku jest wykonywany, wyświetlając przydatne informacje w etykiecie ExceptionDetails .

Na tym etapie lista DataList nie podejmuje żadnych starań, aby zapobiec wystąpieniu wyjątków w pierwszej kolejności. Mimo że wiemy, że ujemna cena spowoduje wyjątek, nie dodaliśmy jeszcze żadnych funkcji, aby aktywnie uniemożliwić użytkownikowi wprowadzanie takich nieprawidłowych danych wejściowych. W następnym samouczku zobaczymy, jak zmniejszyć liczbę wyjątków spowodowanych nieprawidłowymi danymi wejściowymi użytkownika przez dodanie kontrolek weryfikacji w pliku EditItemTemplate.

Szczęśliwe programowanie!

Dalsze informacje

Aby uzyskać więcej informacji na temat tematów omówionych w tym samouczku, zapoznaj się z następującymi zasobami:

Wyjątki — zalecenia dotyczące projektowania
Moduły rejestrowania błędów i programy obsługi (ELMAH) (biblioteka typu open source na potrzeby błędów rejestrowania)
Biblioteka przedsiębiorstwa dla programu .NET Framework 2.0 (obejmuje blok aplikacji zarządzania wyjątkami)

Informacje o autorze

Scott Mitchell, autor siedmiu książek ASP/ASP.NET i założyciel 4GuysFromRolla.com, współpracuje z technologiami internetowymi firmy Microsoft od 1998 roku. Scott pracuje jako niezależny konsultant, trener i pisarz. Jego najnowsza książka to Sams Teach Yourself ASP.NET 2.0 w 24 godzinach. Można go uzyskać pod adresem mitchell@4GuysFromRolla.com. lub za pośrednictwem swojego bloga, który można znaleźć na stronie http://ScottOnWriting.NET.

Specjalne podziękowania

Ta seria samouczków została omówiona przez wielu przydatnych recenzentów. Główny recenzent tego samouczka to Ken Pespisa. Chcesz przejrzeć nadchodzące artykuły MSDN? Jeśli tak, upuść mi wiersz pod adresem mitchell@4GuysFromRolla.com.

Poprzedni Następny

Udostępnij za pośrednictwem