Utilizando el API de IIS 7 para crear Web Sites Aplicaciones, Directorios Virtuales y para explorar mi servidor Web desde .NET

En días pasados tuve la necesidad de crear una aplicación que me permitiera llevar a cabo acciones sobre el IIS para poder realizar acciones tales como crear un Sitio Web desde una aplicación desarrollada en C#. Es por eso, que en este post decidí escribir un poco acerca de como llevar a cabo estas tareas utilizando VS 2008, C#, IIS 7.0 y el API manejado para acceder las funcionalidades del IIS – al menos algunas.

El API de IIS 7.0 es una librería localizada en el directorio C:\Windows\System32\inetsrv\ – Asumiendo que la instalación de Windows esta en el disco C – y es un assemblie que se llama Microsoft.Web.Administration.dll. Esta vez, vamos a hacer una aplicación de consola que nos permita realizar un par de tareas contra el IIS.

Una vez creada la aplicación de consola procedemos a agregar una referencia al componente que nos va a exponer la funcionalidad disponible del IIS, es decir, el Microsoft.Web.Administration.dll. La siguiente figura nos muestra la referencia agregada al proyecto de ejemplo.

Una vez agregada esta referencia, procedemos agregar la referencia a la libreria para poder utilizarla en nuestra aplicación tal y como se muestra en el siguiente código:

using System;
using Microsoft.Web.Administration;

Luego a agregar funcionalidad a nuestra aplicacion para acceder al IIS 7.0. Lo primero que vamos a hacer es desplegar la lista de sitios web que han sido creados en el IIS con el que vamos a interactuar, en este caso, el servidor Web local. El código para llevar a cabo este procedimiento es el siguiente.

static void Main( string[] args )
{
    ListarSitiosWeb( );
}

private static void ListarSitiosWeb( )
{
    using (ServerManager server = new ServerManager( ))
    {
        foreach (Site site in server.Sites)
        {
            Console.WriteLine("Sitio Web:{0}", site.Name);
        }
    }
}

Como se ve en el código anterior, lo primero que debemos hacer es crear una instancia de la clase ServerManager, la cual representa el servidor Web instalado en mi máquina. Seguidamente, para imprimir el nombre de los sitios web creados en el servidor Web simplemente recorro la colección de Sites presente en mi servidor web. La salida de este código es:

Para crear un Sitio web desde mi aplicación en .NET utilizo el siguiente código.

/// <summary>
/// Permite crear un web site utilizando el API de IIS 7
/// </summary>
/// <param name="siteName">El nombre del sitio web</param>
public static void CreateSite( string siteName )
{
    try
    {
        using (ServerManager mgr = new ServerManager( ))
        {
            Site newSite = mgr.Sites.CreateElement( );
            newSite.Id = DateTime.Now.Second;
            newSite.SetAttributeValue("name", siteName);
            mgr.Sites.Add(newSite);
            mgr.CommitChanges( );
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("Error: {0}", ex.ToString( ));
    }
}

Este código permite crear un sitio web con el nombre que viene por parámetro – siteName – y con un Id obtenido del segundo en que fue creado el sitio web. Seguidamente agregamos el sitio a la colección de sitios del IIS, y le damos CommitChanges para refrescar el sitio web.

Otra funcionalidad con la que tenemos que trabajar cuando creamos es crear una Aplicación. Una aplicación en IIS es un agrupamiento de contenido en un sitio Web. Estas aplicaciones tienen una ruta física para el contenido y propiedades que son específicas al contenido indicado. Para crear una aplicación en el sitio web antes creado agregamos el siguiente código.

private static void AgregarAplicacion( string sitioWeb )
{
    try
    {
        using (ServerManager server = new ServerManager( ))
        {
            server.Sites[sitioWeb].Applications.Add("/", @"C:\Proyectos\MiSitio");
            server.CommitChanges( );
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("Error creando aplicación {0}: {1}", sitioWeb, ex.ToString( ));
    }
}

En este código, el método Add de la colección de aplicaciones del sitio web recibe dos parámetros, el primero es la ruta dentro del servidor web donde se va a administrar el contenido – en este caso en el directorio raíz del sitio web - , y el segundo parámetro que indica la ubicación física del contenido.

Por último, le vamos a agregar un directorio virtual a la aplicación que acabamos de crear.

public static void AgregarDirectorioVirtual( string nombreSitioWeb, string aplicacion )
{
    using (ServerManager server = new ServerManager( ))
    {
        Site sitioWeb = server.Sites[nombreSitioWeb];
        Application app = sitioWeb.Applications[aplicacion];
        app.VirtualDirectories.Add("/ASPX", @"C:\Proyectos\MiSitio");
        server.CommitChanges( );
    }
}

Este código agregar un directorio virtual llamado ASPX, en la ruta física C:\Proyectos\MiSitio, por lo tanto va a estar mapeado a esta dirección física.