Batch-frissítések végrehajtása (VB)

által Scott Mitchell

PDF letöltése

Megtudhatja, hogyan hozhat létre teljes mértékben szerkeszthető DataListet, amelyben az összes elem szerkesztési módban van, és amelynek értékei menthetők a lapon található "Az összes frissítése" gombra kattintva.

Bevezetés

Az előző oktatóanyagban megvizsgáltuk, hogyan hozható létre elemszintű DataList. A szabványos szerkeszthető GridView-hoz hasonlóan a DataList minden eleme tartalmazott egy Szerkesztés gombot, amely kattintás után szerkeszthetővé tenné az elemet. Bár ez az elemszintű szerkesztés jól működik az olyan adatok esetében, amelyek csak alkalmanként frissülnek, bizonyos használati esetek esetén a felhasználónak számos rekordot kell szerkesztenie. Ha egy felhasználónak több tucat rekordot kell szerkesztenie, és a Szerkesztés gombra kell kattintania, végezze el a módosításokat, és kattintson mindegyiknél a Frissítés gombra, a kattintás mennyisége akadályozhatja a termelékenységet. Ilyen helyzetekben jobb megoldás egy teljes mértékben szerkeszthető DataList biztosítása, amelyben az összes elem szerkesztési módban van, és amelynek értékei szerkeszthetők a lapon található Összes frissítése gombra kattintva (lásd az 1. ábrát).

1. ábra: A teljes mértékben szerkeszthető adatlista minden eleme módosítható (ide kattintva megtekintheti a teljes méretű képet)

Ebben az oktatóanyagban azt vizsgáljuk meg, hogyan engedélyezheti a felhasználók számára a szállítók címadatainak frissítését egy teljes mértékben szerkeszthető DataList használatával.

1. lépés: A szerkeszthető felhasználói felület létrehozása a DataList s ItemTemplate-ban

Az előző oktatóanyagban, amelyben egy szabványos, elemszintű szerkeszthető DataListet hoztunk létre, két sablont használtunk:

• ItemTemplate tartalmazta az írásvédett felhasználói felületet (az egyes termékek nevének és árának megjelenítésére szolgáló címke webes vezérlői).
• EditItemTemplate tartalmazta a szerkesztési mód felhasználói felületét (a két TextBox webvezérlőt).

A DataList tulajdonsága EditItemIndex határozza meg, hogy mely elem DataListItem van megjelenítve a EditItemTemplate segítségével, ha van ilyen. A DataListItem, amelynek ItemIndex értéke megegyezik a DataList EditItemIndex tulajdonságával, különösen a EditItemTemplate segítségével kerül megjelenítésre. Ez a modell akkor működik jól, ha egyszerre csak egy elem szerkeszthető, de teljesen szerkeszthető DataList létrehozásakor szétesik.

Teljes mértékben szerkeszthető DataList esetén azt szeretnénk, hogy az DataListItem adat renderelhető legyen a szerkeszthető felületen. Ennek legegyszerűbb módja a szerkeszthető felület definiálása a ItemTemplate. A szállítók címadatainak módosításához a szerkeszthető felület szövegként tartalmazza a szállító nevét, majd a cím, a város és az ország/régió értékeinek szövegmezőit.

Először nyissa meg a BatchUpdate.aspx lapot, adjon hozzá egy DataList-vezérlőt, és állítsa be a tulajdonságát ID a következőre Suppliers: . A DataList intelligens címkéjéről válassza ki az új ObjectDataSource-vezérlő hozzáadását, amely SuppliersDataSource nevű.

2. ábra: Új ObjectDataSource névvel ellátott SuppliersDataSource objektum létrehozása (ide kattintva megtekintheti a teljes méretű képet)

Konfigurálja az ObjectDataSource-t az adatok lekérésére az SuppliersBLL osztály metódusával GetSuppliers() (lásd a 3. ábrát). Az előző oktatóanyaghoz hasonlóan a szállítói adatok ObjectDataSource-on keresztüli frissítése helyett közvetlenül az üzleti logikai réteggel fogunk dolgozni. Ezért állítsa a legördülő listát (Nincs) a FRISSÍTÉS lapon (lásd a 4. ábrát).

3. ábra: Szállítói adatok lekérése a GetSuppliers() módszerrel (kattintson ide a teljes méretű kép megtekintéséhez)

4. ábra: Állítsa a Drop-Down listát (Nincs) a FRISSÍTÉS lapon (ide kattintva megtekintheti a teljes méretű képet)

A varázsló befejezése után a Visual Studio automatikusan létrehozza a DataList s-eket ItemTemplate , hogy megjelenítse az adatforrás által visszaadott összes adatmezőt egy Címke webvezérlőben. Úgy kell módosítanunk ezt a sablont, hogy az inkább a szerkesztőfelületet nyújtsa. ItemTemplate testre szabható a Tervező használatával a DataList intelligens címke Sablonok szerkesztése opciója vagy közvetlenül a deklaratív szintaxis használata révén.

Hozzon létre egy szerkesztőfelületet, amely szövegként jeleníti meg a szállító nevét, de tartalmazza a szállító címének, városának és ország/régió értékeinek Szövegmezőit. A módosítások elvégzése után a lap deklaratív szintaxisának a következőhöz hasonlóan kell kinéznie:

<asp:DataList ID="Suppliers" runat="server" DataKeyField="SupplierID"
    DataSourceID="SuppliersDataSource">
    <ItemTemplate>
        <h4><asp:Label ID="CompanyNameLabel" runat="server"
            Text='<%# Eval("CompanyName") %>' /></h4>
        <table border="0">
            <tr>
                <td class="SupplierPropertyLabel">Address:</td>
                <td class="SupplierPropertyValue">
                    <asp:TextBox ID="Address" runat="server"
                        Text='<%# Eval("Address") %>' />
                </td>
            </tr>
            <tr>
                <td class="SupplierPropertyLabel">City:</td>
                <td class="SupplierPropertyValue">
                    <asp:TextBox ID="City" runat="server"
                        Text='<%# Eval("City") %>' />
                </td>
            </tr>
            <tr>
                <td class="SupplierPropertyLabel">Country:</td>
                <td class="SupplierPropertyValue">
                    <asp:TextBox ID="Country" runat="server"
                        Text='<%# Eval("Country") %>' />
                </td>
            </tr>
        </table>
        <br />
    </ItemTemplate>
</asp:DataList>
<asp:ObjectDataSource ID="SuppliersDataSource" runat="server"
    OldValuesParameterFormatString="original_{0}"
    SelectMethod="GetSuppliers" TypeName="SuppliersBLL">
</asp:ObjectDataSource>

Megjegyzés:

Az előző oktatóanyaghoz hasonlóan az oktatóanyagban szereplő DataList nézetállapotának engedélyezve kell lennie.

ItemTemplate I-ben két új CSS osztályt használok, SupplierPropertyLabel és SupplierPropertyValue, amelyek hozzá lettek adva az Styles.css osztályhoz, és úgy vannak konfigurálva, hogy ugyanazokat a stílusbeállításokat használják, mint a ProductPropertyLabel és ProductPropertyValue CSS osztályok.

.ProductPropertyLabel, .SupplierPropertyLabel
{
    font-weight: bold;
    text-align: right;
}
.ProductPropertyValue, .SupplierPropertyValue
{
    padding-right: 35px;
}

Miután végrehajtotta ezeket a módosításokat, látogasson el erre a lapra egy böngészőben. Ahogy az 5. ábrán látható, minden DataList-elem szövegként jeleníti meg a szállító nevét, és a TextBoxes használatával jeleníti meg a címet, a várost és az országot/régiót.

5. ábra: A DataList minden szállítója szerkeszthető (ide kattintva megtekintheti a teljes méretű képet)

2. lépés: Az Összes frissítése gomb hozzáadása

Bár az 5. ábrán minden szállító címe, városa és ország/régió mezője megjelenik egy Szövegmezőben, jelenleg nincs elérhető Frissítés gomb. Elemenként a Frissítés gomb helyett a teljes mértékben szerkeszthető DataLists funkcióval általában egyetlen Frissítés minden gombja található a lapon, amely kattintáskor frissíti az összes rekordot a DataListben. Ebben az oktatóanyagban adjunk hozzá két Update All gombot – egyet a lap tetején, egyet pedig alul (bár mindkét gombra kattintva ugyanaz a hatása lesz).

Először adjon hozzá egy gombweb vezérlőelemet a DataList fölé, és állítsa be a tulajdonságát ID a következőre UpdateAll1: . Ezután adja hozzá a második Button Web kontrollt a DataList alatt, és állítsa be az értékét ID-ről UpdateAll2-re. Állítsd be a Text tulajdonságait a két gombnál az Összes frissítése lehetőségre. Végül hozzon létre eseménykezelőket mindkét Button-eseményhez Click . Ahelyett, hogy a frissítési logikát minden egyes eseménykezelőnél megismételnénk, alakítsuk át ezt a logikát egy harmadik metódussá, UpdateAllSupplierAddresses úgy, hogy az eseménykezelők egyszerűen csak ezt a harmadik metódust hívják meg.

Protected Sub UpdateAll1_Click(sender As Object, e As EventArgs) _
    Handles UpdateAll1.Click
    UpdateAllSupplierAddresses()
End Sub
Protected Sub UpdateAll2_Click(sender As Object, e As EventArgs) _
    Handles UpdateAll2.Click
    UpdateAllSupplierAddresses()
End Sub
Private Sub UpdateAllSupplierAddresses()
    ' TODO: Write code to update _all_ of the supplier addresses in the DataList
End Sub

A 6. ábrán az Összes frissítése gomb hozzáadása utáni lap látható.

6. ábra: Két "Update All" gomb lett hozzáadva az oldalhoz (kattintson ide a teljes méretű kép megtekintéséhez)

3. lépés: Az összes szállító címadatainak frissítése

Az összes DataList-elem megjeleníti a szerkesztőfelületet, és a Frissítés minden gombja mellett csak a kötegfrissítés végrehajtásához szükséges kódot kell írni. Pontosabban végig kell lépnünk a DataList-elemeken, és mindegyikhez meg kell hívnunk az SuppliersBLL osztály s UpdateSupplierAddress metódusát.

A DataListet alkotó példányok gyűjteménye DataListItem a DataList tulajdonságánItems keresztül érhető el. Egy hivatkozással DataListItemmegragadhatjuk a megfelelőt SupplierID a DataKeys gyűjteményből, és programozott módon hivatkozhatunk a TextBox webvezérlőire a ItemTemplate következő kódban látható módon:

Private Sub UpdateAllSupplierAddresses()
    ' Create an instance of the SuppliersBLL class
    Dim suppliersAPI As New SuppliersBLL()
    ' Iterate through the DataList's items
    For Each item As DataListItem In Suppliers.Items
        ' Get the supplierID from the DataKeys collection
        Dim supplierID As Integer = Convert.ToInt32(Suppliers.DataKeys(item.ItemIndex))
        ' Read in the user-entered values
        Dim address As TextBox = CType(item.FindControl("Address"), TextBox)
        Dim city As TextBox = CType(item.FindControl("City"), TextBox)
        Dim country As TextBox = CType(item.FindControl("Country"), TextBox)
        Dim addressValue As String = Nothing, _
            cityValue As String = Nothing, _
            countryValue As String = Nothing
        If address.Text.Trim().Length > 0 Then
            addressValue = address.Text.Trim()
        End If
        If city.Text.Trim().Length > 0 Then
            cityValue = city.Text.Trim()
        End If
        If country.Text.Trim().Length > 0 Then
            countryValue = country.Text.Trim()
        End If
        ' Call the SuppliersBLL class's UpdateSupplierAddress method
        suppliersAPI.UpdateSupplierAddress _
            (supplierID, addressValue, cityValue, countryValue)
    Next
End Sub

Amikor a felhasználó az Összes frissítése gomb egyikére kattint, a UpdateAllSupplierAddresses metódus végigfut a DataListItem elemein a Suppliers DataListben, és meghívja az SuppliersBLL osztály UpdateSupplierAddress metódusát, átadva a megfelelő értékeket. A cím, város vagy ország/régió nem megadott értéke Nothing és UpdateSupplierAddress közötti érték lesz (nem üres sztring), ami adatbázis bejegyzést eredményez az alapul szolgáló rekord mezői számára.

Megjegyzés:

Fejlesztésként érdemes lehet hozzáadni egy állapotcímke webvezérlőt a laphoz, amely megerősítést küld a kötegfrissítés végrehajtása után.

Csak a módosított címek frissítése

Az oktatóanyaghoz használt kötegelt frissítési algoritmus meghívja a UpdateSupplierAddress metódust a DataList minden szállítójára, függetlenül attól, hogy módosultak-e a címadataik. Bár az ilyen vak frissítések általában nem teljesítményproblémák, felesleges rekordokhoz vezethetnek, ha újra naplózzák az adatbázistábla módosításait. Ha például eseményindítókkal rögzíti az összes UPDATE s-t a Suppliers táblában egy naplózási táblában, minden alkalommal, amikor a felhasználó az Összes frissítése gombra kattint, egy új naplózási rekord jön létre a rendszer minden szállítója számára, függetlenül attól, hogy a felhasználó végzett-e módosításokat.

A ADO.NET DataTable és DataAdapter osztályokat úgy tervezték, hogy támogassák a kötegelt frissítéseket, ahol csak a módosított, törölt és új rekordok eredményeznek adatbázis-kommunikációt. A DataTable minden sorában van egy RowState tulajdonság , amely jelzi, hogy a sor hozzá lett-e adva a DataTable-hoz, törölve lett-e belőle, módosítva vagy változatlan marad-e. A DataTable kezdeti feltöltésekor az összes sor változatlanul lesz megjelölve. Ha a sor bármelyik oszlopának értékét megváltoztatjuk, a sor módosítottnak lesz jelölve.

SuppliersBLL Az osztályban úgy frissítjük a megadott szállítói címadatokat, hogy először beolvasjuk az egyetlen szállítói rekordot egybeSuppliersDataTable, majd a következő kóddal állítjuk be a Address, Cityés Country az oszlop értékeit:

Public Function UpdateSupplierAddress _
    (supplierID As Integer, address As String, city As String, country As String) _
    As Boolean
    Dim suppliers As Northwind.SuppliersDataTable = _
        Adapter.GetSupplierBySupplierID(supplierID)
    If suppliers.Count = 0 Then
        ' no matching record found, return false
        Return False
    Else
        Dim supplier As Northwind.SuppliersRow = suppliers(0)
        If address Is Nothing Then
            supplier.SetAddressNull()
        Else
            supplier.Address = address
        End If
        If city Is Nothing Then
            supplier.SetCityNull()
        Else
            supplier.City = city
        End If
        If country Is Nothing Then
            supplier.SetCountryNull()
        Else
            supplier.Country = country
        End If
        ' Update the supplier Address-related information
        Dim rowsAffected As Integer = Adapter.Update(supplier)
        ' Return true if precisely one row was updated, otherwise false
        Return rowsAffected = 1
    End If
End Function

Ez a kód naiv módon rendeli hozzá a megadott cím-, város-, és ország-/régióértékeket a SuppliersRow a SuppliersDataTable címére, függetlenül attól, hogy az értékek változtak-e. Ezek a módosítások miatt az SuppliersRow s RowState tulajdonság módosultként van megjelölve. Az adatelérési réteg metódusának Update meghívásakor azt látja, hogy a SupplierRow metódus módosult, ezért parancsot UPDATE küld az adatbázisnak.

Tegyük fel azonban, hogy ehhez a metódushoz kódot adtunk hozzá, hogy csak akkor rendeljük hozzá a megadott cím-, város- és ország-/régióértékeket, ha azok eltérnek a SuppliersRow meglévő értékektől. Abban az esetben, ha a cím, a város és az ország/régió megegyezik a meglévő adatokkal, nem történik módosítás, és az SupplierRow s-ek RowState változatlanként lesznek megjelölve. A nettó eredmény az, hogy a DAL metódus Update meghívásakor a rendszer nem fog adatbázis-hívást kezdeményezni, mert az SuppliersRow nem lett módosítva.

A módosítás végrehajtásához cserélje le azokat az utasításokat, amelyek vakon rendelik hozzá a továbbított cím, város és ország/régió értékeit a következő kódra:

' Only assign the values to the SupplierRow's column values if they differ
If address Is Nothing AndAlso Not supplier.IsAddressNull() Then
    supplier.SetAddressNull()
ElseIf (address IsNot Nothing AndAlso supplier.IsAddressNull) _
    OrElse (Not supplier.IsAddressNull() AndAlso _
                String.Compare(supplier.Address, address) <> 0) Then
    supplier.Address = address
End If
If city Is Nothing AndAlso Not supplier.IsCityNull() Then
    supplier.SetCityNull()
ElseIf (city IsNot Nothing AndAlso supplier.IsCityNull) _
    OrElse (Not supplier.IsCityNull() AndAlso _
                String.Compare(supplier.City, city) <> 0) Then
    supplier.City = city
End If
If country Is Nothing AndAlso Not supplier.IsCountryNull() Then
    supplier.SetCountryNull()
ElseIf (country IsNot Nothing AndAlso supplier.IsCountryNull) _
    OrElse (Not supplier.IsCountryNull() AndAlso _
                String.Compare(supplier.Country, country) <> 0) Then
    supplier.Country = country
End If

Ezzel a hozzáadott kóddal a DAL metódus Update csak azoknak a rekordoknak küld utasítást UPDATE az adatbázisnak, amelyek címhez kapcsolódó értékei megváltoztak.

Azt is nyomon követhetjük, hogy van-e különbség a megadott címmezők és az adatbázis adatai között, és ha nincs, egyszerűen megkerüljük a DAL metódus hívását Update . Ez a módszer jól működik, ha a közvetlen adatbázis-metódust használja, mivel ennél a közvetlen adatbázis-metódusnál nem ad át egy SuppliersRow példányt, amelynek RowState ellenőrizhető lenne annak meghatározására, hogy valóban szükséges-e egy adatbázis-hívás.

Megjegyzés:

Minden alkalommal, amikor a UpdateSupplierAddress metódust meghívják, a rendszer meghívja az adatbázist a frissített rekord adatainak lekéréséhez. Ezután, ha bármilyen változás történik az adatokban, a rendszer egy másik hívást indít az adatbázishoz a táblasor frissítéséhez. Ezt a munkafolyamatot úgy lehet optimalizálni, hogy létrehoz egy metódus-túlterhelést UpdateSupplierAddress, amely elfogad egy EmployeesDataTable példányt, amely rendelkezik az oldal BatchUpdate.aspx módosításával. Ezután egyetlen hívást indíthat az adatbázishoz, hogy lekérje az összes rekordot a Suppliers táblából. Ezután a két eredményhalmaz enumerálható, és csak azokat a rekordokat lehet frissíteni, amelyekben változások történtek.

Összefoglalás

Ebben az oktatóanyagban bemutattuk, hogyan hozhat létre teljes mértékben szerkeszthető DataListet, amely lehetővé teszi, hogy a felhasználók gyorsan módosíthassák több szállító címadatait. A szerkesztőfelület definiálásával egy TextBox webvezérlőt határoztunk meg a dataList-ek szállítói cím-, város- és ország-/régióértékeihez ItemTemplate. Ezután hozzáadtuk az Összes frissítése gombot a DataList fölött és alatt. Miután egy felhasználó végrehajtotta a módosításait, és az Összes frissítése gomb egyikére kattintott, a DataListItem-kat felsorolják, és meghívják az SuppliersBLL osztály UpdateSupplierAddress metódusát.

Boldog programozást!

Tudnivalók a szerzőről

Scott Mitchell, hét ASP/ASP.NET-könyv szerzője és a 4GuysFromRolla.com alapítója, 1998 óta dolgozik a Microsoft webtechnológiáival. Scott független tanácsadóként, edzőként és íróként dolgozik. Legújabb könyve Sams Tanuld meg ASP.NET 2.0 24 óra alatt. Ő itt elérhető mitchell@4GuysFromRolla.com.

Külön köszönet

Ezt az oktatóanyag-sorozatot sok hasznos véleményező áttekintette. Az oktatóanyag vezető véleményezői Zack Jones és Ken Pespisa voltak. Szeretné áttekinteni a közelgő MSDN-cikkeimet? Ha igen, írj egy sort a mitchell@4GuysFromRolla.com-ra.

ElőzőKövetkező