Aracılığıyla paylaş

Toplu Güncelleştirmeler Gerçekleştirme (C#)

tarafından Scott Mitchell

PDF'i indirin

Sayfadaki bir "Tümünü Güncelleştir" düğmesine tıklayarak tüm öğelerinin düzenleme modunda olduğu ve değerlerinin kaydedilebileceği tam olarak düzenlenebilir bir DataList oluşturmayı öğrenin.

Giriş

Önceki öğreticide, öğe düzeyinde DataList oluşturmayı inceledik. Standart düzenlenebilir GridView gibi, DataList'teki her öğe tıklandığında öğeyi düzenlenebilir hale getirecek bir Düzenle düğmesi içeriyordu. Bu öğe düzeyinde düzenleme yalnızca zaman zaman güncelleştirilen veriler için iyi çalışsa da, bazı kullanım örneği senaryoları kullanıcının birçok kaydı düzenlemesini gerektirir. Bir kullanıcının onlarca kaydı düzenlemesi gerekiyorsa ve Düzenle'ye tıklamaya, değişikliklerini yapmaya ve her biri için Güncelleştir'e tıklamaya zorlanırsa, tıklama miktarı üretkenliğini olumsuzleştirebilir. Böyle durumlarda, tüm öğelerinin düzenleme modunda olduğu ve sayfadaki Tümünü Güncelleştir düğmesine tıklayarak değerleri düzenlenebilen tam olarak düzenlenebilir bir DataList sağlamak daha iyi bir seçenektir (bkz. Şekil 1).

Tam Olarak Düzenlenebilir Bir DataList içindeki Her Öğe Değiştirilebilir

Şekil 1: Tam Olarak Düzenlenebilir Bir DataList'teki Her Öğe Değiştirilebilir (Tam boyutlu görüntüyü görüntülemek için tıklayın)

Bu öğreticide, kullanıcıların tamamen düzenlenebilir bir DataList kullanarak sağlayıcı adres bilgilerini güncelleştirmesini sağlamayı inceleyeceğiz.

1. Adım: DataList'in ItemTemplate öğesinde Düzenlenebilir Kullanıcı Arabirimi oluşturma

Standart, öğe düzeyinde düzenlenebilir bir DataList oluşturduğumuz önceki öğreticide iki şablon kullandık:

  • ItemTemplate salt okunur kullanıcı arabirimini içeriyordu (her ürünün adını ve fiyatını görüntülemek için Etiket Web denetimleri).
  • EditItemTemplate düzenleme modu kullanıcı arabirimini (iki TextBox Web denetimi) içeriyordu.

DataList özelliği, EditItemIndex kullanılarak hangi DataListItem'ın (varsa) EditItemTemplate ile işlendiğini belirler. Özellikle DataListItem'nin ItemIndex değeri, DataList'in EditItemIndex özelliğiyle eşleştiğinde EditItemTemplate kullanılarak işlenir. Bu model, bir kerede yalnızca bir öğe düzenlenebiliyorsa iyi çalışır, ancak tam olarak düzenlenebilir bir DataList oluşturulurken parçalanır.

Tamamen düzenlenebilir bir DataList için , tüm sn'nin DataListItem düzenlenebilir arabirim kullanılarak işlenmesini istiyoruz. Bunu yapmanın en basit yolu içinde ItemTemplatedüzenlenebilir arabirimi tanımlamaktır. Sağlayıcı adres bilgilerini değiştirmek için düzenlenebilir arabirim, sağlayıcı adını metin olarak ve ardından adres, şehir ve ülke/bölge değerleri için TextBoxes'ı içerir.

Sayfayı BatchUpdate.aspx açarak başlayın, bir DataList denetimi ekleyin ve ID özelliğini Suppliers olarak ayarlayın. DataList'in akıllı etiketinden adlı SuppliersDataSourceyeni bir ObjectDataSource denetimi eklemeyi tercih edin.

SuppliersDataSource Adlı Yeni Bir ObjectDataSource Oluşturma

Şekil 2: Adlı SuppliersDataSource Yeni Bir ObjectDataSource Oluşturma (Tam boyutlu görüntüyü görüntülemek için tıklayın)

ObjectDataSource'ı SuppliersBLL sınıfının GetSuppliers() yöntemini kullanarak veri alacak şekilde yapılandırın (bkz. Şekil 3). Önceki öğreticide olduğu gibi, ObjectDataSource aracılığıyla sağlayıcı bilgilerini güncelleştirmek yerine doğrudan İş Mantığı Katmanı ile çalışacağız. Bu nedenle, GÜNCELLEŞTIR sekmesinde açılan listeyi (Yok) olarak ayarlayın (bkz. Şekil 4).

GetSuppliers() Yöntemini Kullanarak Sağlayıcı Bilgilerini Alma

Şekil 3: Yöntemi Kullanarak GetSuppliers() Sağlayıcı Bilgilerini Alma (Tam boyutlu görüntüyü görüntülemek için tıklayın)

GÜNCELLEŞTIR sekmesinde Drop-Down Listesi'ni (Yok) olarak ayarlayın

Şekil 4: UPDATE Sekmesinde Drop-Down Listesi'ni (Yok) olarak ayarlayın (Tam boyutlu görüntüyü görüntülemek için tıklayın)

Sihirbazı tamamladıktan sonra Visual Studio, veri kaynağı tarafından döndürülen her veri alanını bir Etiket Web denetiminde görüntülemek için DataList'leri ItemTemplate otomatik olarak oluşturur. Bunun yerine düzenleme arabirimini sağlaması için bu şablonu değiştirmemiz gerekir. ItemTemplate Tasarımcı'da, DataList'in akıllı etiketinden Şablonları Düzenle seçeneğiyle veya doğrudan deklaratif söz dizimi kullanılarak özelleştirilebilir.

Sağlayıcının adını metin olarak görüntüleyen, ancak sağlayıcının adresi, şehri ve ülke/bölge değerleri için TextBoxes içeren bir düzenleme arabirimi oluşturmak için biraz bekleyin. Bu değişiklikleri yaptıktan sonra sayfanızın bildirim temelli söz dizimi aşağıdakine benzer olmalıdır:

<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>

Uyarı

Önceki öğreticide olduğu gibi, bu öğreticideki DataList'in görünüm durumunun etkinleştirilmiş olması gerekir.

ItemTemplate içinde iki yeni CSS sınıfı SupplierPropertyLabel ve SupplierPropertyValue kullanıyorum, bunlar Styles.css sınıfına eklendi ve ProductPropertyLabel ve ProductPropertyValue CSS sınıflarıyla aynı stil ayarlarını kullanacak şekilde yapılandırıldı.

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

Bu değişiklikleri yaptıktan sonra tarayıcı üzerinden bu sayfayı ziyaret edin. Şekil 5'te gösterildiği gibi, her DataList öğesi sağlayıcı adını metin olarak görüntüler ve adresi, şehri ve ülkeyi/bölgeyi görüntülemek için TextBoxes kullanır.

DataList'teki her Sağlayıcı Düzenlenebilir

Şekil 5: DataList'teki her Sağlayıcı Düzenlenebilir (Tam boyutlu görüntüyü görüntülemek için tıklayın)

2. Adım: Tümünü Güncelleştir Düğmesi Ekleme

Şekil 5'teki her sağlayıcının adres, şehir ve ülke/bölge alanları TextBox'ta görüntülense de, şu anda Güncelleştirme düğmesi yoktur. Öğe başına bir Güncelleştir düğmesinin olması yerine, tamamen düzenlenebilir DataLists ile sayfada, tıklandığında DataList'teki tüm kayıtları güncelleştiren tek bir Tümünü Güncelleştir düğmesi bulunur. Bu öğreticide, biri sayfanın en üstünde, diğeri de altta olmak üzere iki Tümünü Güncelleştir düğmesi ekleyelim (her iki düğmeye tıklanması da aynı etkiye sahip olacaktır).

DataList'in üzerine bir Button Web denetimi ekleyerek başlayın ve ID özelliğini UpdateAll1 olarak ayarlayın. Ardından, DataList'in altına ikinci Button Web denetimini ekleyin ve denetimi ID olarak UpdateAll2 ayarlayın. Text İki Düğmenin özelliklerini Tümünü Güncelleştir olarak ayarlayın. Son olarak, her iki Düğme Click olayı için de olay işleyicileri oluşturun. Olay işleyicilerinin her birinde güncelleştirme mantığını yinelemek yerine, olay işleyicilerinin bu üçüncü yöntemi çağırması için bu mantığı üçüncü bir yöntemle UpdateAllSupplierAddressesyeniden düzenleyelim.

protected void UpdateAll1_Click(object sender, EventArgs e)
{
    UpdateAllSupplierAddresses();
}
protected void UpdateAll2_Click(object sender, EventArgs e)
{
    UpdateAllSupplierAddresses();
}
private void UpdateAllSupplierAddresses()
{
    // TODO: Write code to update _all_ of the supplier addresses in the DataList
}

Şekil 6'da Tümünü Güncelleştir düğmeleri eklendikten sonra sayfa gösterilir.

Sayfaya İki Tüm Güncelleme Düğmesi eklendi

Şekil 6: Sayfaya İki Tüm Düğmeyi Güncelleştir eklendi (Tam boyutlu görüntüyü görüntülemek için tıklayın)

3. Adım: Tüm Tedarikçilerin Adres Bilgilerini Güncelleştirme

DataList öğelerinin tümü düzenleme arabirimini görüntülerken ve Tümünü Güncelleştir düğmelerinin eklenmesiyle, geriye kalan tek şey toplu güncelleştirmeyi gerçekleştirmek için kodu yazmaktır. Özellikle DataList öğeleri arasında döngü yapmamız ve her biri için sınıfın SuppliersBLLUpdateSupplierAddress yöntemini çağırmamız gerekir.

DataList'i DataListItem oluşturan örneklerin koleksiyonuna DataList Items özelliği aracılığıyla erişilebilir. DataListItem referansıyla, SupplierID koleksiyonundan karşılık gelen DataKeys'i alabilir ve aşağıdaki kod ile gösterildiği gibi ItemTemplate içindeki TextBox Web denetimlerine program aracılığıyla başvurabiliriz.

private void UpdateAllSupplierAddresses()
{
    // Create an instance of the SuppliersBLL class
    SuppliersBLL suppliersAPI = new SuppliersBLL();
    // Iterate through the DataList's items
    foreach (DataListItem item in Suppliers.Items)
    {
        // Get the supplierID from the DataKeys collection
        int supplierID = Convert.ToInt32(Suppliers.DataKeys[item.ItemIndex]);
        // Read in the user-entered values
        TextBox address = (TextBox)item.FindControl("Address");
        TextBox city = (TextBox)item.FindControl("City");
        TextBox country = (TextBox)item.FindControl("Country");
        string addressValue = null, cityValue = null, countryValue = null;
        if (address.Text.Trim().Length > 0)
            addressValue = address.Text.Trim();
        if (city.Text.Trim().Length > 0)
              cityValue = city.Text.Trim();
        if (country.Text.Trim().Length > 0)
            countryValue = country.Text.Trim();
        // Call the SuppliersBLL class's UpdateSupplierAddress method
        suppliersAPI.UpdateSupplierAddress
            (supplierID, addressValue, cityValue, countryValue);
    }
}

Kullanıcı Tümünü Güncelleştir düğmelerinden birine tıkladığında, UpdateAllSupplierAddresses yöntemi DataListItem DataList'teki her Suppliers üzerinde yinelenir ve ilgili değerleri geçirerek SuppliersBLL sınıfının UpdateSupplierAddress yöntemini çağırır. Adres, şehir veya ülke/bölge için girilmemiş bir değer olduğunda, (boş bir dize yerine) Nothing'den UpdateSupplierAddress'e bir değer geçirilir ve bu, ilgili kayıt alanları için bir veritabanı NULL sonucu verir.

Uyarı

Geliştirme olarak, toplu güncelleştirme gerçekleştirildikten sonra sayfaya bir onay iletisi sağlayan bir durum Etiketi Web denetimi eklemek isteyebilirsiniz.

Yalnızca değiştirilmiş olan adresleri güncelleştirme

Bu öğretici için kullanılan toplu güncelleme algoritması, adres bilgilerinin değiştirilip değiştirilmediğine bakılmaksızın UpdateSupplierAddress tedarikçi için DataList'teki yöntemini çağırır. Bu tür kör güncelleştirmeler genellikle bir performans sorunu olmasa da, veritabanı tablosundaki değişiklikleri denetlerseniz gereksiz kayıtlara yol açabilir. Örneğin, tablodaki tüm UPDATE değerleri bir denetim tablosuna Suppliers kaydetmek için tetikleyiciler kullanırsanız, bir kullanıcı Tümünü Güncelleştir düğmesine her tıkladığınızda, kullanıcının herhangi bir değişiklik yapıp yapmadığını dikkate almadan sistemdeki her sağlayıcı için yeni bir denetim kaydı oluşturulur.

ADO.NET DataTable ve DataAdapter sınıfları, yalnızca değiştirilen, silinen ve yeni kayıtların herhangi bir veritabanı iletişimine neden olduğu toplu güncelleştirmeleri destekleyecek şekilde tasarlanmıştır. DataTable'daki her satır, satırın DataTable'a eklendiğini, silindiğini, değiştirildiğini veya değişmediğini gösteren bir RowState özelliğe sahiptir. DataTable ilk olarak doldurulduğunda, tüm satırlar değişmeden işaretlenir. Satır sütunlarından herhangi birinin değerinin değiştirilmesi, satırı değiştirilmiş olarak işaretler.

SuppliersBLL sınıfında, belirtilen sağlayıcının adres bilgilerini güncelleştirmek için önce tek sağlayıcı kaydını bir SuppliersDataTable olarak okuyacağız ve ardından aşağıdaki kodu kullanarak , Addressve City sütun değerlerini ayarlayacağızCountry:

public bool UpdateSupplierAddress
    (int supplierID, string address, string city, string country)
{
    Northwind.SuppliersDataTable suppliers =
        Adapter.GetSupplierBySupplierID(supplierID);
    if (suppliers.Count == 0)
        // no matching record found, return false
        return false;
    else
    {
        Northwind.SuppliersRow supplier = suppliers[0];
        if (address == null)
            supplier.SetAddressNull();
        else
            supplier.Address = address;
        if (city == null)
            supplier.SetCityNull();
        else
            supplier.City = city;
        if (country == null)
            supplier.SetCountryNull();
        else
            supplier.Country = country;
        // Update the supplier Address-related information
        int rowsAffected = Adapter.Update(supplier);
        // Return true if precisely one row was updated,
        // otherwise false
        return rowsAffected == 1;
    }
}

Bu kod, değerlerin değişip değişmediğine bakılmaksızın adres, şehir ve ülke/bölge değerlerini SuppliersRow içindeki SuppliersDataTable öğesine atar. Bu değişiklikler, SuppliersRow s RowState özelliğinin değiştirilmiş olarak işaretlenmesine neden olur. Veri Erişim Katmanı s Update yöntemi çağrıldığında, öğesinin SupplierRow değiştirildiğini görür ve bu nedenle veritabanına bir UPDATE komut gönderir.

Öte yandan, bu yönteme yalnızca mevcut değerlerden SuppliersRow farklıysa geçirilen adres, şehir ve ülke/bölge değerlerini atamak için kod eklediğimizi düşünün. Adresin, şehrin ve ülkenin/bölgenin mevcut veriyle aynı olması durumunda hiçbir değişiklik yapılmaz ve SupplierRow bunlar RowState değişmemiş olarak işaretlenir. Net sonuç, DAL s Update yöntemi çağrıldığında, SuppliersRow değiştirilmediği için veritabanı çağrısının yapılmamasıdır.

Bu değişikliği uygulamak için, geçirilen adres, şehir ve ülke/bölge değerlerini körü körüne atayan deyimleri aşağıdaki kodla değiştirin:

// Only assign the values to the SupplierRow's column values if they differ
if (address == null && !supplier.IsAddressNull())
    supplier.SetAddressNull();
else if ((address != null && supplier.IsAddressNull()) ||
         (!supplier.IsAddressNull() &&
         string.Compare(supplier.Address, address) != 0))
    supplier.Address = address;
if (city == null && !supplier.IsCityNull())
    supplier.SetCityNull();
else if ((city != null && supplier.IsCityNull()) ||
         (!supplier.IsCityNull() && string.Compare(supplier.City, city) != 0))
    supplier.City = city;
if (country == null && !supplier.IsCountryNull())
    supplier.SetCountryNull();
else if ((country != null && supplier.IsCountryNull()) ||
         (!supplier.IsCountryNull() &&
         string.Compare(supplier.Country, country) != 0))
    supplier.Country = country;

Bu eklenen kodla, DAL s Update yöntemi veritabanına yalnızca adresle ilgili değerleri değiştirilmiş olan kayıtlar için bir UPDATE deyim gönderir.

Alternatif olarak, geçirilen adres alanları ile veritabanı verileri arasında herhangi bir fark olup olmadığını izleyebilir ve yoksa DAL s Update yöntemine yapılan çağrıyı atlayabiliriz. DB doğrudan yöntemini kullanıyorsanız bu yaklaşım iyi çalışır, çünkü DB doğrudan yöntemi veritabanı çağrısının gerçekten gerekli olup olmadığını belirlemek için denetlenebilen bir SuppliersRow örneğine RowState geçmez.

Uyarı

UpdateSupplierAddress Yöntem her çağrıldığında, güncelleştirilmiş kayıt hakkındaki bilgileri almak için veritabanına bir çağrı yapılır. Daha sonra verilerde herhangi bir değişiklik olursa, tablo satırını güncelleştirmek için veritabanına başka bir çağrı yapılır. Bu iş akışı, sayfadaki UpdateSupplierAddress değişiklikleri EmployeesDataTable içeren bir örneği kabul eden bir BatchUpdate.aspx yöntem aşırı yüklemesi oluşturularak iyileştirilebilir. Ardından, tablodaki tüm kayıtları Suppliers almak için veritabanına tek bir çağrı yapabilir. Bu durumda iki sonuç kümesinin listesi oluşturulabilir ve yalnızca değişikliklerin gerçekleştiği kayıtlar güncelleştirilebilir.

Özet

Bu öğreticide, kullanıcının birden çok sağlayıcının adres bilgilerini hızlı bir şekilde değiştirmesine olanak sağlayan, tam olarak düzenlenebilir bir DataList oluşturmayı gördük. DataList'in ItemTemplateiçindeki sağlayıcı adresi, şehir ve ülke/bölge değerleri için düzenleme arabirimini bir TextBox Web denetimi tanımlayarak başladık. Ardından DataList'in üstüne ve altına Tümünü Güncelleştir düğmeleri ekledik. Kullanıcı, değişikliklerini yaptıktan ve Tümünü Güncelleştir düğmelerinden birine tıkladıktan sonra, DataListItem'ler numaralandırılır ve SuppliersBLL sınıfının UpdateSupplierAddress yöntemi çağrılır.

Mutlu Programlama!

Yazar Hakkında

Yedi ASP/ASP.NET kitabının yazarı ve 4GuysFromRolla.com kurucusu Scott Mitchell, 1998'den beri Microsoft Web teknolojileriyle çalışmaktadır. Scott bağımsız bir danışman, eğitmen ve yazar olarak çalışır. Son kitabı Sams Teach Yourself ASP.NET 24 Hours 2.0'dır. Ona adresinden mitchell@4GuysFromRolla.comulaşabilirsiniz.

Özel Teşekkürler

Bu eğitim serisi, birçok yararlı kişi tarafından incelendi. Bu rehberin ana gözden geçirenleri Zack Jones ve Ken Pespisa'ydı. Yaklaşan MSDN makalelerimi gözden geçirmek istiyor musunuz? Öyleyse, mitchell@4GuysFromRolla.com'a bir mesaj bırakın.

ÖncekiSonraki

  • Last updated on