Comenzando con ASP.NET AJAX Control Toolkit

El AJAX Control Toolkit (ACT) es un proyecto código abierto (open source) construido alrededor de ASP.NET AJAX. Contiene un conjunto de controles habilitados para AJAX que podemos usar para fácilmente hacer nuestras paginas mas interactivas.

Puedes descargar AJAX Control Toolkit desde CodePlex. La versión actual es 40412. Descarga el archivo AjaxControlToolkit.Binary.NET4.zip.

En el archivo .zip encontraras el archivo AjaxControlToolkit.dll. Copia el archivo a una ubicación compartida desde donde puedas referenciar el archivo en todos tus proyectos. Por ejemplo, C:\Componentes\AjaxControlToolkit\.

Si otros programadores estarán trabajando en el mismo proyecto, quizá querrás hacer otra copia del archivo y ponerla dentro de la carpeta del proyecto. Por ejemplo, puedes crear una carpeta llamada !ref o REF en la carpeta del proyecto y poner la .dll ahí.

No es necesario copiar esta carpeta al servidor web cuando estés listo(a) para lanzar el sitio web a producción, ya que el compilador pondrá otra copia del archivo en la carpeta BIN.

Abre Visual Studio o Visual Web Developer Express. Crea una nueva Aplicación Web o abre el proyecto en el cual deseas utilizar Ajax Control Toolkit.

Agrega una referencia a AjaxControlToolkit.dll desde la ubicación que hayas elegido.

Si queremos utilizar los controles en una pagina, agregaríamos esta línea al inicio de la pagina, justo debajo de la directiva <%@ Page %>.

<%@ Register Assembly="AjaxControlToolkit" Namespace="AjaxControlToolkit" TagPrefix="asp" %>

Si deseas hacer los controles disponibles en todas las paginas del proyecto, puedes agregar esto al web.config. Ya no será necesario registrar los controles en cada pagina.

    <pages>
      <controls>
        <add assembly="AjaxControlToolkit" namespace="AjaxControlToolkit" tagPrefix="asp" />
      </controls>
    </pages>

También podemos agregar los controles a la caja de herramientas (toolbox).

1. Haz clic derecho en la caja de herramientas.
2. Selecciona Agregar Ficha (Add Tab).
3. Escribe Ajax Control Toolkit para nombrar la nueva ficha.
4. Haz clic derecho dentro de la nueva ficha.
5. Selecciona Elegir Elementos (Choose Items).
6. Haz clic en Examinar (Browse).
7. Encuentra el archivo AjaxControlToolkit.dll. Es una buena idea utilizar una ubicación compartida como mencione anteriormente.
8. Todos los controles estarán seleccionados. Haz clic en Aceptar (OK).

Todos los controles estarán ahora disponibles para poder arrastrar y agregar a tus paginas con facilidad.

Ya que AJAX Control Toolkit esta construido alrededor de ASP.NET AJAX, necesitamos agregar un control ScriptManager o un ScriptManagerProxy a la pagina donde vamos a utilizar los controles. Esto lo discutimos en el post anterior.

<asp:ScriptManager ID="ScriptManager1" runat="server" />

ACT también ofrece su propio control ToolkitScriptManager que podemos utilizar en lugar de ScriptManager.

<asp:ToolkitScriptManager ID="ToolkitScriptManager1" runat="server" />

Si ninguno de estos controles se encuentra en la pagina, recibirás la excepción MissingManifestResourceException con un error como este:

Could not find any resources appropriate for the specified culture or the neutral culture.  Make sure “AjaxControlToolkit.Properties.Resources.NET4.resources” was correctly embedded or linked into assembly “AjaxControlToolkit” at compile time, or that all the satellite assemblies required are loadable and fully signed.

Ahora ya estas listo(a) para usar los controles en tu pagina. Puedes ver los controles en acción en la pagina de ejemplos oficial.