Giriş » PROGRAMLAMA » Anthem kütüphanesini tanıyalım 1 – asp.net ajax yazıları

Anthem kütüphanesini tanıyalım 1 – asp.net ajax yazıları

02 Aralık 2007 | Kategori: PROGRAMLAMA | Yazar: anov

Selamlar, bir süredir anthem kullanan biri olarak, ms topluluklarında anthem ile ilgili yazılara ajax control toolkit için yazılanlara oranla oldukça az rastladığımdan, bu yazıyı yazmaya karar verdim.5 Aralık 2007 Eklemesi : Anthem in ve genel olarak ajax ın ne işe yaradığı ile ilgili bir giriş yapmadığım için sonradan ekliyorum.

Anthem kütüphanesinin amacı nedir? Neden onu kullanma gereği duyabiliriz?

Anthem, asp.net içinde kullanılabilen ajax destekli bir bileşen kütüphanesidir. Zaten yazılmış olan bir asp.net kodunu çok az değişiklikle ajax destekli hale getirmenizi sağlar. Aslında arka planda (kullandığı xmlhttprequest nesnesi ile) tam bir sayfa isteğinde bulunur, ancak sadece belirttiğiniz kontrollerde meydana gelen değişiklikleri sayfanıza yansıtır.

Şimdi isterseniz, anthem ile daha önce hiç tanışmamış asp.net e yeni merak salmış veya asp.net bilip de anthem i daha önce kullanmamış kişilerden birinin yerine kendimizi koyalım ve adım adım ona rehberlik edelim. Ne yapması gerekir bu şahsın ki sayfalar yenilenmeden işlemlerini tamamlayabilsin.

1-) Anthem i bulalım:

http://www.anthemdotnet.com
Adresinden takip ederek şu indirme bağlantısını buluyoruz :
http://sourceforge.net/project/showfiles.php?group_id=151897

2-) Anthem i kuralım:

Anthem size bir proje dosyası (sln) ve c sharp projesi olarak gelecektir (csproj). Eğer Visual Studio kullanıyorsanız zaten derlemekte bir problem yaşamayacaksınız. Ama eğer Visual Studio nuz yoksa bu kodları derlemek için çeşitli seçenekleriniz mevcuttur. Visual c# 2005 veya 2008 express ile derleyebilirsiniz, veya zaten sizde .net framework 2.0 sdk kurulu ise komut satırından msbuild aracını kullanabilirsiniz. Ek bir kurulum gerektirmediği için ben msbuild ile derlemeyi tercih ettim.

Anthem kütüphanesini tanıyalım 1 asp.net ajax yazıları programlama

Haydi derleyelim :-)
Anthem kütüphanesini tanıyalım 1 asp.net ajax yazıları programlama

msbuild aracının kullanılışı:
Anthem kütüphanesini tanıyalım 1 asp.net ajax yazıları programlama

"Build succeeded" yazısını gördükten sonra hemen kütüphaneyi indirdiğim klasöre gidip bakıyorum. Şu an için release modunda değil, debug modunda derledim, görsel araçları kullanan arkadaşlarım, kolayca anthem içine girip bu inşa işlemi sonunda oluşan dll in içinde hata ayıklayabilirler.

Anthem kütüphanesini tanıyalım 1 asp.net ajax yazıları programlama

Bir asp.net projesinin (veya sanal dizinin – virtual directory-) /bin klasörüne bu .dll i eklemeniz gerekiyor. Bin klasörüne kopyaladıktan hemen sonra, bu dll kullanıma hazır olacaktır.

3-) Basit bir örnek ile mantığını kavrayalım:

Çoğu (ne yazık ki "hepsi" diyemiyorum) asp.net kontrolünün anthem eşdeğerleri vardır. Var olan bir asp.net sayfasını anthem ile ajax-destekli hale getirmek için yapacağınız değişiklikler çok azdır.

<%@ Register Assembly="Anthem" Namespace="Anthem" TagPrefix="anthem" %>(Burada TagPrefix istediğimiz gibi değiştirilebilir, ancak anlamayı kolaylaştırmak namına ben de aynı bırakıyorum.) Bu satırı aspx sayfanızın başına eklemelisiniz.
asp:TextBox yerine anthem:TextBox gibi kontroller kullanacaksınız.
Eğer o kontrolün yapılan ajax çağrısından sonra güncellenmesini istiyorsanız, AutoUpdateAfterCallBack="true" ile veya sayfa yüklenirken kod ile güncelleşmesini sağlayabilirsiniz.

İşte iki sayıyı toplayan ve sonucu yazan basit bir örnek:

<%@ Page Language="C#"%>
<%@ Register Assembly="Anthem" Namespace="Anthem" TagPrefix="anthem" %>
<script runat="server">
protected void buttonTopla_Click(object sender, EventArgs e)
{
    try
    {
    labelSonuc.Text = (Convert.ToInt32(sayi1.Text)+Convert.ToInt32(sayi2.Text)).ToString();
    }
    catch
    {
       labelSonuc.Text = "Hey adamım senin problemin ne?";
    }
    finally
    {
       sayi1.Text = "";
       sayi2.Text = "";
    }
}
</script>
<html>
<head>
<title>Çok basit bir anthem örneği</title>
</head>
<body>
<form runat="server">
    <anthem:TextBox ID="sayi1" runat="server" AutoUpdateAfterCallBack="true"/>
    <anthem:Button ID="buttonTopla" runat="server" Text="+" OnClick="buttonTopla_Click"

TextDuringCallBack="Bekleyiniz…"/>
    <anthem:TextBox ID="sayi2" runat="server" AutoUpdateAfterCallBack="true"/>
    =
    <anthem:Label ID="labelSonuc" runat="server" AutoUpdateAfterCallBack="true"/>
</form>
</body>
</html>

Ve işte sonuç :

"Bekleyiniz…" yazısını sonuç çok hızlı geldiği için göremeyebilirsiniz.

4-) Dikkat edilmesi gereken hususlar:

Anthem ile iş yaparken dikkatimi çeken sıkça yaptığım hatalar şunlar idi:

Eğer bir anthem:GridView inden herhangi bir textbox yakalıyorsak veya datalist içindeki kontrollere FindControl ile müdahale ediyorsak, bu kontrolleri Anthem.TextBox, Anthem.CheckBox gibi anthem eşdeğerlerine dönüştürmeliyiz. Zaten karşınıza çıkan hata mesajı yeterince yönlendirici olacaktır, ama bu hatayla uğraşmıştım bir süre. İkincisi, eğer normal bir olay çağrısının (event handler) CallBack sonucu gerçekleşip gerçekleşmediğini tespit etmek için Anthem.Manager.IsCallBack kullanabilirsiniz.

Bu yazının birinci kısmını burada bitiriyorum. İsterseniz, indirdiğimiz anthem dosyalarıyla beraber gelen Anthem-Examples-2005 klasörünü sanal dizin haline getirip örnekleri inceleyerek bu yazıdan öğrendiğinizden çok daha fazlasını öğrenmeniz mümkündür. Zaten kaynak olarak sıklıkla oraya başvurdum, ilk başladığımda.

Arama Terimleri:

asp net örnek, asp net Örnekler, sena yazıları, ajax bileşenlerini kullanma asp net, c sharp sln dosyası problemli

Benzer Konular:

Ajax Asp.net FilteredTextBoxExtender AJAX ASP.net control toolkit ile FilteredTextBoxExtender bilesenin bir iki web projem icin hemen kullandim, eger nedir, nasil kullanilir diye merak...
Ajax ControlToolKit I Ajax asp.net ile birlikte oldukca zengin bir set geliyor, bu setin icinde benim kullanirken cok eglendigim birkac bilesen var, simdi...
Ajax ControlTookit II Dunku yazimda Ajax ControlToolKit ile gelen dragpanelextender, textboxwatermarkextender, alwaysvisible kontrollerini kisaca anlatmaya calismistim. Bugun birkac tane daha kontrolu gostermek istiyorum....

Yazar anov - 02 Aralık 2007. Kategori PROGRAMLAMA. Bu yazıya yazılan yazıları RSS üzerinden takip edebilirsiniz RSS 2.0. Yorum yazabilir veya geri izlemede bulunabilirsiniz.