Aggiornamento batch (C#)
Informazioni su come aggiornare più record di database in una singola operazione. Nel livello dell'interfaccia utente viene creato un controllo GridView in cui ogni riga è modificabile. Nel livello di accesso ai dati vengono eseguite il wrapping di più operazioni di aggiornamento all'interno di una transazione per assicurarsi che tutti gli aggiornamenti abbiano esito positivo o venga eseguito il rollback di tutti gli aggiornamenti.
Introduzione
Nell'esercitazione precedente è stato illustrato come estendere il livello di accesso ai dati per aggiungere il supporto per le transazioni di database. Le transazioni di database garantiscono che una serie di istruzioni di modifica dei dati venga considerata come un'unica operazione atomica, in modo da garantire che tutte le modifiche avranno esito negativo o tutte avranno esito positivo. Con questa funzionalità DAL di basso livello, siamo pronti a rivolgere l'attenzione alla creazione di interfacce di modifica dei dati batch.
In questa esercitazione verrà creato un controllo GridView in cui ogni riga è modificabile (vedere la figura 1). Poiché viene eseguito il rendering di ogni riga nell'interfaccia di modifica, non è necessaria alcuna colonna dei pulsanti Modifica, Aggiornamento e Annulla. Nella pagina sono invece presenti due pulsanti Aggiorna prodotti che, quando si fa clic, enumera le righe gridView e aggiorna il database.
Figura 1: Ogni riga in GridView è modificabile (fare clic per visualizzare l'immagine a dimensione intera)
Iniziamo!
Nota
Nell'esercitazione Esecuzione di batch Aggiornamenti è stata creata un'interfaccia di modifica batch usando il controllo DataList. Questa esercitazione è diversa da quella precedente, in quanto usa un controllo GridView e l'aggiornamento batch viene eseguito nell'ambito di una transazione. Dopo aver completato questa esercitazione, è consigliabile tornare all'esercitazione precedente e aggiornarla per usare la funzionalità relativa alle transazioni del database aggiunta nell'esercitazione precedente.
Esame dei passaggi per rendere modificabili tutte le righe gridView
Come illustrato nell'esercitazione Panoramica dell'inserimento, dell'aggiornamento e dell'eliminazione dei dati , GridView offre il supporto predefinito per la modifica dei dati sottostanti in base a riga. Internamente, GridView annota la riga modificabile tramite la relativa EditIndex proprietà. Poiché GridView è associato all'origine dati, controlla ogni riga per verificare se l'indice della riga è uguale al valore di EditIndex. In tal caso, il rendering dei campi della riga viene eseguito usando le relative interfacce di modifica. Per BoundFields, l'interfaccia di modifica è un controllo TextBox la cui Text proprietà è assegnata al valore del campo dati specificato dalla proprietà BoundField s DataField . Per TemplateFields, viene EditItemTemplate usato al posto di ItemTemplate.
Tenere presente che il flusso di lavoro di modifica inizia quando un utente fa clic sul pulsante Modifica di una riga. In questo modo viene generato un postback, viene impostata la proprietà gridView sull'indice EditIndex della riga selezionata e i dati vengono riassociati alla griglia. Quando si fa clic sul pulsante Annulla di una riga, al postback viene EditIndex impostato su un valore di -1 prima di riassociare i dati alla griglia. Poiché le righe di GridView iniziano l'indicizzazione a zero, l'impostazione EditIndex su -1 ha l'effetto di visualizzare GridView in modalità di sola lettura.
La EditIndex proprietà funziona bene per la modifica per riga, ma non è progettata per la modifica in batch. Per rendere modificabile l'intero controllo GridView, è necessario eseguire il rendering di ogni riga usando la relativa interfaccia di modifica. Il modo più semplice per eseguire questa operazione consiste nel creare la posizione in cui ogni campo modificabile viene implementato come TemplateField con la relativa interfaccia di modifica definita in ItemTemplate.
Nei passaggi successivi verrà creato un controllo GridView completamente modificabile. In Step 1 we'll start by creating the GridView and its ObjectDataSource and convert its BoundFields and CheckBoxField into TemplateFields. Nei passaggi 2 e 3 le interfacce di modifica verranno spostate da TemplateFields EditItemTemplate a ItemTemplate s.
Passaggio 1: Visualizzazione delle informazioni sul prodotto
Prima di preoccuparsi di creare un controllo GridView in cui le righe sono modificabili, è sufficiente visualizzare le informazioni sul prodotto. Aprire la BatchUpdate.aspx pagina nella BatchData cartella e trascinare un controllo GridView dalla casella degli strumenti nella Designer. Impostare GridView su IDProductsGrid e, dallo smart tag, scegliere di associarlo a un nuovo ObjectDataSource denominato ProductsDataSource. Configurare ObjectDataSource per recuperare i dati dal ProductsBLL metodo della GetProducts classe .
Figura 2: Configurare ObjectDataSource per l'uso della classe (fare clic per visualizzare l'immagineProductsBLL a dimensione intera)
Figura 3: Recuperare i dati del prodotto usando il GetProducts metodo (fare clic per visualizzare l'immagine a dimensione intera)
Analogamente a GridView, le funzionalità di modifica di ObjectDataSource sono progettate per funzionare in base alle righe. Per aggiornare un set di record, è necessario scrivere un bit di codice nella classe code-behind della pagina ASP.NET che esegue il batch dei dati e lo passa al BLL. Impostare pertanto gli elenchi a discesa nelle schede UPDATE, INSERT e DELETE di ObjectDataSource su (Nessuno). Fare clic su Fine per completare la procedura guidata.
Figura 4: Impostare il Drop-Down Elenchi nelle schede UPDATE, INSERT e DELETE su (Nessuno) (Fare clic per visualizzare l'immagine a dimensione intera)
Dopo aver completato la procedura guidata Configura origine dati, il markup dichiarativo di ObjectDataSource dovrebbe essere simile al seguente:
<asp:ObjectDataSource ID="ProductsDataSource" runat="server"
OldValuesParameterFormatString="original_{0}"
SelectMethod="GetProducts" TypeName="ProductsBLL">
</asp:ObjectDataSource>
Se si completa la procedura guidata Configura origine dati, Visual Studio crea anche BoundFields e checkBoxField per i campi dati del prodotto in GridView. Per questa esercitazione, consentire all'utente di visualizzare e modificare solo il nome, la categoria, il prezzo e lo stato sospeso del prodotto. Rimuovere tutti i ProductNamecampi , CategoryName, UnitPrice, e Discontinued e rinominare le HeaderText proprietà dei primi tre campi rispettivamente in Product, Category e Price. Infine, selezionare le caselle di controllo Abilita paging e Abilita ordinamento nello smart tag gridView.
A questo punto GridView ha tre BoundFields (ProductName, CategoryNamee UnitPrice) e un CheckBoxField (Discontinued). È necessario convertire questi quattro campi in TemplateFields e quindi spostare l'interfaccia di modifica da TemplateField a EditItemTemplate .ItemTemplate
Nota
È stata esaminata la creazione e la personalizzazione di TemplateFields nell'esercitazione Personalizzazione dell'interfaccia di modifica dei dati . Verranno illustrati i passaggi per convertire BoundFields e CheckBoxField in TemplateFields e definire le relative interfacce di modifica nei rispettivi ItemTemplate oggetti, ma se ci si blocca o è necessario un aggiornamento, non esitare a fare riferimento a questa esercitazione precedente.
Dallo smart tag gridView fare clic sul collegamento Modifica colonne per aprire la finestra di dialogo Campi. Selezionare quindi ogni campo e fare clic sul collegamento Converti questo campo in un campo Modello.
Figura 5: Convertire i campi boundfield e checkbox esistenti in un campo modello
Ora che ogni campo è un campo TemplateField, è possibile spostare l'interfaccia di modifica da EditItemTemplate s a ItemTemplate s.
Passaggio 2: Creazione diProductNameUnitPrice interfacce eDiscontinuedmodifica
La creazione delle ProductNameinterfacce , UnitPricee di Discontinued modifica sono l'argomento di questo passaggio e sono piuttosto semplici, perché ogni interfaccia è già definita in TemplateField s EditItemTemplate. La creazione dell'interfaccia CategoryName di modifica è un po' più complessa perché è necessario creare un elenco a discesa delle categorie applicabili. Questa CategoryName interfaccia di modifica viene affrontata nel passaggio 3.
Iniziamo con TemplateField ProductName . Fare clic sul collegamento Modifica modelli dallo smart tag gridView e eseguire il drill-down in ProductName TemplateField s EditItemTemplate. Selezionare il controllo TextBox, copiarlo negli Appunti e incollarlo in ProductName TemplateField s ItemTemplate. Modificare la proprietà TextBox s ID in ProductName.
Aggiungere quindi un RequiredFieldValidator a ItemTemplate per assicurarsi che l'utente fornisca un valore per ogni nome del prodotto. Impostare la ControlToValidate proprietà su ProductName, la ErrorMessage proprietà su È necessario specificare il nome del prodotto. e la Text proprietà su *. Dopo aver eseguito queste aggiunte a , la ItemTemplateschermata dovrebbe essere simile alla figura 6.
Figura 6: TemplateField ProductName include ora un controllo TextBox e un oggetto RequiredFieldValidator (fare clic per visualizzare l'immagine a dimensione intera)
Per l'interfaccia UnitPrice di modifica, iniziare copiando il controllo TextBox da EditItemTemplate a ItemTemplate. Posizionare quindi un oggetto $ davanti a TextBox e impostarne la ID proprietà su UnitPrice e la relativa Columns proprietà su 8 .
Aggiungere anche compareValidator a UnitPrice s ItemTemplate per assicurarsi che il valore immesso dall'utente sia un valore di valuta valido maggiore o uguale a $0,00. Impostare la proprietà del ControlToValidate validator su UnitPrice, la relativa ErrorMessage proprietà su È necessario immettere un valore di valuta valido. Omettere qualsiasi simbolo di valuta., la relativa Text proprietà su *, la relativa Type proprietà su Currency, la relativa Operator proprietà su GreaterThanEquale la relativa ValueToCompare proprietà su 0 .
Figura 7: Aggiungere un compareValidator per verificare che il prezzo immesso sia un valore di valuta non negativo (fare clic per visualizzare l'immagine a dimensione intera)
Discontinued Per TemplateField è possibile usare checkBox già definito in ItemTemplate. È sufficiente impostarne ID su Discontinued e la relativa Enabled proprietà su true.
Passaggio 3: Creazione dell'interfacciaCategoryNamedi modifica
L'interfaccia CategoryName di modifica in TemplateField contiene EditItemTemplate un controllo TextBox che visualizza il valore del CategoryName campo dati. È necessario sostituirlo con un elenco a discesa che elenca le categorie possibili.
Nota
L'esercitazione Personalizzazione dell'interfaccia di modifica dei dati contiene una discussione più approfondita e completa sulla personalizzazione di un modello per includere un oggetto DropDownList anziché un controllo TextBox. Mentre i passaggi qui sono completati, vengono presentati in modo tersely. Per un'analisi più approfondita della creazione e della configurazione delle categorie DropDownList, vedere l'esercitazione Personalizzazione dell'interfaccia di modifica dei dati .
Trascinare un oggetto DropDownList dalla casella degli strumenti nel CategoryName campo TemplateField, ItemTemplateimpostandone il ID valore su Categories. A questo punto si definirà in genere l'origine dati dropDownLists tramite lo smart tag, creando un nuovo ObjectDataSource. Tuttavia, verrà aggiunto ObjectDataSource all'interno di ItemTemplate, che comporterà la creazione di un'istanza ObjectDataSource per ogni riga gridView. Creare invece ObjectDataSource all'esterno di TemplateFields di GridView. Terminare la modifica del modello e trascinare ObjectDataSource dalla casella degli strumenti nella Designer sotto ProductsDataSource ObjectDataSource. Denominare il nuovo ObjectDataSource CategoriesDataSource e configurarlo per l'uso del CategoriesBLL metodo della GetCategories classe .
Figura 8: Configurare ObjectDataSource per l'uso della classe (fare clic per visualizzare l'immagineCategoriesBLL a dimensione intera)
Figura 9: Recuperare i dati delle categorie usando il GetCategories metodo (fare clic per visualizzare l'immagine a dimensione intera)
Poiché ObjectDataSource viene usato solo per recuperare i dati, impostare gli elenchi a discesa nelle schede UPDATE e DELETE su (Nessuno). Fare clic su Fine per completare la procedura guidata.
Figura 10: Impostare il Drop-Down Elenchi nelle schede UPDATE e DELETE su (Nessuno) (Fare clic per visualizzare l'immagine a dimensione intera)
Al termine della procedura guidata, il CategoriesDataSource markup dichiarativo dovrebbe essere simile al seguente:
<asp:ObjectDataSource ID="CategoriesDataSource" runat="server"
OldValuesParameterFormatString="original_{0}"
SelectMethod="GetCategories" TypeName="CategoriesBLL">
</asp:ObjectDataSource>
Dopo la creazione e la CategoriesDataSource configurazione, tornare a CategoryName TemplateField s ItemTemplate e, dallo smart tag dropDownList, fare clic sul collegamento Scegli origine dati. Nella configurazione guidata origine dati selezionare l'opzione CategoriesDataSource nel primo elenco a discesa e scegliere di usare CategoryName per la visualizzazione e CategoryID come valore.
Figura 11: Associare l'elenco a discesa a CategoriesDataSource (fare clic per visualizzare l'immagine a dimensione intera)
A questo punto l'elenco Categories a discesa elenca tutte le categorie, ma non seleziona ancora automaticamente la categoria appropriata per il prodotto associato alla riga GridView. A tale scopo, è necessario impostare Categories DropDownList s SelectedValue sul valore del CategoryID prodotto. Fare clic sul collegamento Modifica DataBindings dallo smart tag DropDownList e associare la SelectedValue proprietà al CategoryID campo dati, come illustrato nella figura 12.
Figura 12: Associare il valore del CategoryID prodotto alla proprietà dropDownList s SelectedValue
Un ultimo problema rimane: se il prodotto non ha un CategoryID valore specificato, l'istruzione databinding su SelectedValue genererà un'eccezione. Questo avviene perché DropDownList contiene solo gli elementi per le categorie e non offre un'opzione per i prodotti che hanno un NULL valore di database per CategoryID. Per risolvere questo problema, impostare la proprietà DropDownList su AppendDataBoundItems e aggiungere un nuovo elemento a DropDownList, omettendo la Value proprietà dalla sintassi dichiarativa.true In altri casi, assicurarsi che la Categories sintassi dichiarativa di DropDownList sia simile alla seguente:
<asp:DropDownList ID="Categories" runat="server" AppendDataBoundItems="True"
DataSourceID="CategoriesDataSource" DataTextField="CategoryName"
DataValueField="CategoryID" SelectedValue='<%# Bind("CategoryID") %>'>
<asp:ListItem Value=">-- Select One --</asp:ListItem>
</asp:DropDownList>
Si noti che - <asp:ListItem Value=""> Selezionare uno - ha il relativo Value attributo impostato in modo esplicito su una stringa vuota. Fare riferimento all'esercitazione Personalizzazione dell'interfaccia di modifica dei dati per una discussione più approfondita sul motivo per cui questo elemento DropDownList aggiuntivo è necessario per gestire il NULL caso e perché l'assegnazione Value della proprietà a una stringa vuota è essenziale.
Nota
Qui è presente un potenziale problema di prestazioni e scalabilità che vale la pena menzionare. Poiché ogni riga ha un oggetto DropDownList che usa CategoriesDataSource come origine dati, il CategoriesBLL metodo della GetCategories classe verrà chiamato n volte per visita di pagina, dove n è il numero di righe in GridView. Queste n chiamate per GetCategories generare n query al database. Questo impatto sul database può essere ridotto memorizzando nella cache le categorie restituite in una cache per richiesta o tramite il livello di memorizzazione nella cache tramite una dipendenza di memorizzazione nella cache SQL o una scadenza basata su tempo molto breve.
Passaggio 4: Completamento dell'interfaccia di modifica
Sono state apportate alcune modifiche ai modelli di GridView senza sospendere per visualizzare lo stato di avanzamento. Dedicare qualche minuto a visualizzare lo stato di avanzamento tramite un browser. Come illustrato nella figura 13, viene eseguito il rendering di ogni riga usando il relativo ItemTemplate, che contiene l'interfaccia di modifica della cella.
Figura 13: Ogni riga gridView è modificabile (fare clic per visualizzare l'immagine a dimensione intera)
Ci sono alcuni problemi di formattazione secondari che dovremmo occuparsi a questo punto. Si noti innanzitutto che il UnitPrice valore contiene quattro punti decimali. Per risolvere questo problema, tornare a UnitPrice TemplateField s ItemTemplate e, dallo smart tag di TextBox, fare clic sul collegamento Modifica DataBindings. Specificare quindi che la Text proprietà deve essere formattata come numero.
Figura 14: Formattare la Text proprietà come numero
In secondo luogo, è possibile allineare al centro la casella di controllo nella Discontinued colonna anziché allinearla a sinistra. Fare clic su Modifica colonne dallo smart tag gridView e selezionare TemplateField Discontinued nell'elenco dei campi nell'angolo in basso a sinistra. Eseguire il drill-down ItemStyle e impostare la HorizontalAlign proprietà su Center come illustrato nella figura 15.
Figura 15: Centrare il Discontinued controllo CheckBox
Aggiungere quindi un controllo ValidationSummary alla pagina e impostarne la ShowMessageBox proprietà su true e la relativa ShowSummary proprietà su false. Aggiungere anche i controlli Web Button che, quando si fa clic, aggiorneranno le modifiche dell'utente. In particolare, aggiungere due controlli Web Button, uno sopra GridView e uno sotto di esso, impostando entrambe le proprietà dei controlli Text su Aggiorna prodotti .
Poiché l'interfaccia di modifica di GridView è definita nei relativi campi TemplateFields, gli EditItemTemplate oggetti sono superflui ItemTemplate e possono essere eliminati.
Dopo aver apportato le modifiche di formattazione indicate in precedenza, aggiungendo i controlli Button e rimuovendo gli elementi non necessari EditItemTemplate , la sintassi dichiarativa della pagina avrà un aspetto simile al seguente:
<p>
<asp:Button ID="UpdateAllProducts1" runat="server" Text="Update Products" />
</p>
<p>
<asp:GridView ID="ProductsGrid" runat="server" AutoGenerateColumns="False"
DataKeyNames="ProductID" DataSourceID="ProductsDataSource"
AllowPaging="True" AllowSorting="True">
<Columns>
<asp:TemplateField HeaderText="Product" SortExpression="ProductName">
<ItemTemplate>
<asp:TextBox ID="ProductName" runat="server"
Text='<%# Bind("ProductName") %>'></asp:TextBox>
<asp:RequiredFieldValidator ID="RequiredFieldValidator1"
ControlToValidate="ProductName"
ErrorMessage="You must provide the product's name."
runat="server">*</asp:RequiredFieldValidator>
</ItemTemplate>
</asp:TemplateField>
<asp:TemplateField HeaderText="Category"
SortExpression="CategoryName">
<ItemTemplate>
<asp:DropDownList ID="Categories" runat="server"
AppendDataBoundItems="True"
DataSourceID="CategoriesDataSource"
DataTextField="CategoryName"
DataValueField="CategoryID"
SelectedValue='<%# Bind("CategoryID") %>'>
<asp:ListItem>-- Select One --</asp:ListItem>
</asp:DropDownList>
</ItemTemplate>
</asp:TemplateField>
<asp:TemplateField HeaderText="Price"
SortExpression="UnitPrice">
<ItemTemplate>
$<asp:TextBox ID="UnitPrice" runat="server" Columns="8"
Text='<%# Bind("UnitPrice", "{0:N}") %>'></asp:TextBox>
<asp:CompareValidator ID="CompareValidator1" runat="server"
ControlToValidate="UnitPrice"
ErrorMessage="You must enter a valid currency value.
Please omit any currency symbols."
Operator="GreaterThanEqual" Type="Currency"
ValueToCompare="0">*</asp:CompareValidator>
</ItemTemplate>
</asp:TemplateField>
<asp:TemplateField HeaderText="Discontinued" SortExpression="Discontinued">
<ItemTemplate>
<asp:CheckBox ID="Discontinued" runat="server"
Checked='<%# Bind("Discontinued") %>' />
</ItemTemplate>
<ItemStyle HorizontalAlign="Center" />
</asp:TemplateField>
</Columns>
</asp:GridView>
</p>
<p>
<asp:Button ID="UpdateAllProducts2" runat="server" Text="Update Products" />
<asp:ObjectDataSource ID="ProductsDataSource" runat="server"
OldValuesParameterFormatString="original_{0}"
SelectMethod="GetProducts" TypeName="ProductsBLL">
</asp:ObjectDataSource>
<asp:ObjectDataSource ID="CategoriesDataSource" runat="server"
OldValuesParameterFormatString="original_{0}"
SelectMethod="GetCategories" TypeName="CategoriesBLL">
</asp:ObjectDataSource>
<asp:ValidationSummary ID="ValidationSummary1" runat="server"
ShowMessageBox="True" ShowSummary="False" />
</p>
Nella figura 16 questa pagina viene visualizzata tramite un browser dopo l'aggiunta dei controlli Web Button e le modifiche di formattazione apportate.
Figura 16: La pagina include ora due pulsanti Aggiorna prodotti (fare clic per visualizzare l'immagine a dimensione intera)
Passaggio 5: Aggiornamento dei prodotti
Quando un utente visita questa pagina, apporta le modifiche e quindi fa clic su uno dei due pulsanti Aggiorna prodotti. A questo punto è necessario salvare in qualche modo i valori immessi dall'utente per ogni riga in un'istanza ProductsDataTable di e quindi passarlo a un metodo BLL che passerà quindi tale ProductsDataTable istanza al metodo dal UpdateWithTransaction . Il UpdateWithTransaction metodo creato nell'esercitazione precedente garantisce che il batch di modifiche venga aggiornato come operazione atomica.
Creare un metodo denominato BatchUpdate in BatchUpdate.aspx.cs e aggiungere il codice seguente:
private void BatchUpdate()
{
// Enumerate the GridView's Rows collection and create a ProductRow
ProductsBLL productsAPI = new ProductsBLL();
Northwind.ProductsDataTable products = productsAPI.GetProducts();
foreach (GridViewRow gvRow in ProductsGrid.Rows)
{
// Find the ProductsRow instance in products that maps to gvRow
int productID = Convert.ToInt32(ProductsGrid.DataKeys[gvRow.RowIndex].Value);
Northwind.ProductsRow product = products.FindByProductID(productID);
if (product != null)
{
// Programmatically access the form field elements in the
// current GridViewRow
TextBox productName = (TextBox)gvRow.FindControl("ProductName");
DropDownList categories =
(DropDownList)gvRow.FindControl("Categories");
TextBox unitPrice = (TextBox)gvRow.FindControl("UnitPrice");
CheckBox discontinued =
(CheckBox)gvRow.FindControl("Discontinued");
// Assign the user-entered values to the current ProductRow
product.ProductName = productName.Text.Trim();
if (categories.SelectedIndex == 0)
product.SetCategoryIDNull();
else
product.CategoryID = Convert.ToInt32(categories.SelectedValue);
if (unitPrice.Text.Trim().Length == 0)
product.SetUnitPriceNull();
else
product.UnitPrice = Convert.ToDecimal(unitPrice.Text);
product.Discontinued = discontinued.Checked;
}
}
// Now have the BLL update the products data using a transaction
productsAPI.UpdateWithTransaction(products);
}
Questo metodo inizia recuperando tutti i prodotti in una ProductsDataTable tramite una chiamata al metodo BLL.GetProducts Enumera quindi la ProductGrid raccolta di RowsGridView. La Rows raccolta contiene un'istanzaGridViewRow per ogni riga visualizzata in GridView. Poiché vengono visualizzate al massimo dieci righe per pagina, la raccolta di Rows GridView non avrà più di dieci elementi.
Per ogni riga, l'oggetto ProductIDDataKeys viene afferrato dalla raccolta e l'oggetto appropriato ProductsRow viene selezionato da ProductsDataTable. Ai quattro controlli di input TemplateField viene fatto riferimento a livello di codice e ai relativi valori assegnati alle proprietà dell'istanza ProductsRow . Dopo aver usato ogni valore della riga di GridView per aggiornare ProductsDataTable, viene passato al metodo BLL che UpdateWithTransaction , come illustrato nell'esercitazione precedente, chiama semplicemente nel metodo DAL s UpdateWithTransaction .
L'algoritmo di aggiornamento batch usato per questa esercitazione aggiorna ogni riga di ProductsDataTable che corrisponde a una riga in GridView, indipendentemente dal fatto che le informazioni del prodotto siano state modificate. Anche se tali aggiornamenti ciechi non sono in genere un problema di prestazioni, possono causare record superflui se si controllano le modifiche alla tabella di database. Tornare all'esercitazione Esecuzione di batch Aggiornamenti è stata esaminata un'interfaccia di aggiornamento batch con DataList e è stato aggiunto codice che aggiornerebbe solo i record effettivamente modificati dall'utente. È possibile usare le tecniche di Esecuzione di Aggiornamenti Batch per aggiornare il codice in questa esercitazione, se necessario.
Nota
Quando si associa l'origine dati a GridView tramite lo smart tag, Visual Studio assegna automaticamente i valori di chiave primaria dell'origine dati alla proprietà gridView.DataKeyNames Se objectDataSource non è stato associato a GridView tramite lo smart tag di GridView come descritto nel passaggio 1, sarà necessario impostare manualmente la proprietà gridView su DataKeyNames ProductID per accedere al ProductID valore per ogni riga tramite l'insieme DataKeys .
Il codice usato in BatchUpdate è simile a quello usato nei metodi BLL, UpdateProduct la differenza principale è che nei UpdateProduct metodi viene recuperata solo una singola ProductRow istanza dall'architettura. Il codice che assegna le proprietà di ProductRow è lo stesso tra i UpdateProducts metodi e il codice all'interno del foreach ciclo in BatchUpdate, come è il modello complessivo.
Per completare questa esercitazione, è necessario che il BatchUpdate metodo venga richiamato quando si fa clic su uno dei pulsanti Aggiorna prodotti. Creare gestori eventi per gli Click eventi di questi due controlli Button e aggiungere il codice seguente nei gestori eventi:
BatchUpdate();
ClientScript.RegisterStartupScript(this.GetType(), "message",
"alert('The products have been updated.');", true);
Prima viene effettuata una chiamata a BatchUpdate. ClientScript property Viene quindi usato per inserire JavaScript che visualizzerà una finestra di messaggio che legge I prodotti sono stati aggiornati.
Eseguire un minuto per testare questo codice. Visitare BatchUpdate.aspx un browser, modificare una serie di righe e fare clic su uno dei pulsanti Aggiorna prodotti. Supponendo che non siano presenti errori di convalida dell'input, verrà visualizzata una finestra di messaggio che legge I prodotti sono stati aggiornati. Per verificare l'atomicità dell'aggiornamento, è consigliabile aggiungere un vincolo casuale CHECK , ad esempio un vincolo che non consente UnitPrice valori di 1234.56. Quindi da BatchUpdate.aspxmodificare un numero di record, assicurandosi di impostare uno dei valori del UnitPrice prodotto sul valore non consentito ( 1234,56 ). Questo dovrebbe causare un errore quando si fa clic su Aggiorna prodotti con le altre modifiche durante l'operazione batch di cui è stato eseguito il rollback ai valori originali.
Metodo alternativoBatchUpdate
Il BatchUpdate metodo appena esaminato recupera tutti i prodotti dal metodo BLL e GetProducts quindi aggiorna solo i record visualizzati in GridView. Questo approccio è ideale se GridView non usa il paging, ma se lo fa, potrebbero esserci centinaia, migliaia o decine di migliaia di prodotti, ma solo dieci righe in GridView. In tal caso, ottenere tutti i prodotti dal database solo per modificare 10 di essi è minore dell'ideale.
Per questi tipi di situazioni, è consigliabile usare invece il metodo seguente BatchUpdateAlternate :
private void BatchUpdateAlternate()
{
// Enumerate the GridView's Rows collection and create a ProductRow
ProductsBLL productsAPI = new ProductsBLL();
Northwind.ProductsDataTable products = new Northwind.ProductsDataTable();
foreach (GridViewRow gvRow in ProductsGrid.Rows)
{
// Create a new ProductRow instance
int productID = Convert.ToInt32(ProductsGrid.DataKeys[gvRow.RowIndex].Value);
Northwind.ProductsDataTable currentProductDataTable =
productsAPI.GetProductByProductID(productID);
if (currentProductDataTable.Rows.Count > 0)
{
Northwind.ProductsRow product = currentProductDataTable[0];
// Programmatically access the form field elements in the
// current GridViewRow
TextBox productName = (TextBox)gvRow.FindControl("ProductName");
DropDownList categories =
(DropDownList)gvRow.FindControl("Categories");
TextBox unitPrice = (TextBox)gvRow.FindControl("UnitPrice");
CheckBox discontinued =
(CheckBox)gvRow.FindControl("Discontinued");
// Assign the user-entered values to the current ProductRow
product.ProductName = productName.Text.Trim();
if (categories.SelectedIndex == 0)
product.SetCategoryIDNull();
else
product.CategoryID = Convert.ToInt32(categories.SelectedValue);
if (unitPrice.Text.Trim().Length == 0)
product.SetUnitPriceNull();
else
product.UnitPrice = Convert.ToDecimal(unitPrice.Text);
product.Discontinued = discontinued.Checked;
// Import the ProductRow into the products DataTable
products.ImportRow(product);
}
}
// Now have the BLL update the products data using a transaction
productsAPI.UpdateProductsWithTransaction(products);
}
BatchMethodAlternate inizia creando un nuovo oggetto vuoto ProductsDataTable denominato products. Esegue quindi i passaggi della raccolta di Rows GridView e per ogni riga ottiene le informazioni specifiche sul prodotto usando il metodo BLL.GetProductByProductID(productID) L'istanza recuperata ProductsRow ha le proprietà aggiornate nello stesso modo di BatchUpdate, ma dopo l'aggiornamento della riga importata nel products``ProductsDataTable metodo DataTable.ImportRow(DataRow)
Al termine del ciclo, products contiene un'istanza ProductsRowforeach per ogni riga in GridView. Poiché ognuna delle ProductsRow istanze è stata aggiunta all'oggetto products (anziché aggiornata), se il metodo viene passato in modo cieco al UpdateWithTransaction metodo, ProductsTableAdapter tenterà di inserire ognuno dei record nel database. È invece necessario specificare che ognuna di queste righe è stata modificata (non aggiunta).
Questa operazione può essere eseguita aggiungendo un nuovo metodo al BLL denominato UpdateProductsWithTransaction. UpdateProductsWithTransaction, illustrato di seguito, imposta l'oggetto RowState di ognuna delle ProductsRow istanze nell'oggetto ProductsDataTable e Modified quindi passa il ProductsDataTable valore al metodo S di UpdateWithTransaction DAL.
public int UpdateProductsWithTransaction(Northwind.ProductsDataTable products)
{
// Mark each product as Modified
products.AcceptChanges();
foreach (Northwind.ProductsRow product in products)
product.SetModified();
// Update the data via a transaction
return UpdateWithTransaction(products);
}
Riepilogo
GridView offre funzionalità di modifica predefinite per riga, ma manca il supporto per la creazione di interfacce completamente modificabili. Come abbiamo visto in questa esercitazione, tali interfacce sono possibili, ma richiedono un po 'di lavoro. Per creare un oggetto GridView in cui ogni riga è modificabile, è necessario convertire i campi GridView in TemplateFields e definire l'interfaccia di modifica all'interno di ItemTemplate s. È inoltre necessario aggiungere tutti i controlli Web button -type alla pagina, separati da GridView. Questi gestori di eventi Button Click devono enumerare l'insieme GridView, Rows archiviare le modifiche in un ProductsDataTableoggetto e passare le informazioni aggiornate nel metodo BLL appropriato.
Nell'esercitazione successiva verrà illustrato come creare un'interfaccia per l'eliminazione batch. In particolare, ogni riga di GridView includerà una casella di controllo e invece dei pulsanti Aggiorna tutti i tipi, saranno disponibili pulsanti Elimina righe selezionate.
Programmazione felice!
Informazioni sull'autore
Scott Mitchell, autore di sette libri ASP/ASP.NET e fondatore di 4GuysFromRolla.com, ha lavorato con le tecnologie Microsoft Web dal 1998. Scott lavora come consulente indipendente, allenatore e scrittore. Il suo ultimo libro è Sams Teach Yourself ASP.NET 2,0 in 24 Ore. Può essere raggiunto a mitchell@4GuysFromRolla.com. o tramite il suo blog, che può essere trovato in http://ScottOnWriting.NET.
Grazie speciali
Questa serie di esercitazioni è stata esaminata da molti revisori utili. I revisori principali per questa esercitazione erano Teresa Murphy e David Suru. Interessati a esaminare i prossimi articoli MSDN? In tal caso, lasciami una riga in mitchell@4GuysFromRolla.com.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per