MagicAjax

Hoje vou abordar um assunto que interessa especialmente a quem desenvolve sites e projetos web. É o MagicAjax. É uma biblioteca, ou framework, que facilita um pouco o uso do Ajax, para quem desenvolve projetos para .NET 2.0 ou vai dar manutenção em projetos que não foram criados para suportar Ajax. Para quem não sabe Ajax (Asynchronous Javascript And XML) é uma metodologia ou conjunto de técnicas que fazem uso de javascript  e XML para fazer chamadas de servidor, sem a necessidade de recarregar a página inteira.

Para começar a usar o MagicAjax faça o download dos arquivos necessários neste link: http://sourceforge.net/projects/magicajax/

Após baixar os arquivos, crie um novo web site ou projeto web no Visual Studio.  Na Solution Explorer inclua a referência ao arquivo MagicAjax.dll que você baixou. Para tal clique em References e em Add Reference, e selecione a dll. Em seguida você deve incluir o arquivo AjaxCallObject.js no projeto. Este arquivo também está no pacote que você baixou.

Incluidos a dll e o .js, o próximo passo é alterar o web.config. Abra o web.config e encontrea tag <configuration>. Logo após esta tag inclua o seguinte trecho:

<configSections>

<section name="magicAjax"  type="MagicAjax.Configuration.MagicAjaxSectionHandler, MagicAjax"/>

</configSections>

<magicAjax scriptPath="<caminho dos javascripts>" outputCompareMode="HashCode" tracing="false">

<pageStore mode="NoStore" unloadStoredPage="false" cacheTimeout="5" maxConcurrentPages="5" maxPagesLimitAlert="false"/>

</magicAjax>

Neste bloco, onde diz “<caminho do javascript>”,  coloque o caminho da pasta onde você colocou o javascript. Eu criei uma pasta na raiz do projeto chamada “js”, portanto para mim ficou <magicAjax scriptPath="js">.

Agora procure pela sessão <system.web>. Nesta sessão substitua a linha

<customErrors mode="Off"></customErrors>

Por:

<httpModules>

  <add name="MagicAjax" type="MagicAjax.MagicAjaxModule, MagicAjax"/>

</httpModules>

<customErrors mode="Off"></customErrors>

Agora, para utilizar os componentes do MagicAjax, basta ir na tool box, clicar com o botão direito e selecionar chose itens. Na janela que irá abrir, selecione os componentes do MagicAjax, e confirme.

Agora você já poderá usar Ajax de forma bem simples. Para fazer um teste, crie uma página qualquer e inclua alguns componentes. Inclua também um AjaxPanel. Dentro deste AjaxPanel inclua um <asp:botton> e também uma caixa de texto. Assim:

<ajax:AjaxPanel ID="AjaxPanel1" runat="server">

<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>

<asp:Button ID="Button1" runat="server" Text="Button" onclick="Button1_Click" />

</ajax:AjaxPanel>

No evento Button1_Clik altere a propriedade Text do TextBox1.  Repare que no inicio do arquivo .aspx (segunda linha) o VS insere a linha abaixo. Este é o registro dos controle MagicAjaxs para esta página. 

<%@Register Assembly="MagicAjax" Namespace="MagicAjax.UI.Controls" TagPrefix="ajax" %>

Rode o código implementado e repare que ao clicar no botão o texto do TextBox muda, porém o resto da página não é recarregado.

Existem diversos outros frameworks grátis para utilizar Ajax. Faça seus testes e veja qual atende melhor as suas necessidades.