Vamos a describir como instalar Gentle Net 1.5 en Windows y usarlo en algun proyecto .Net.

1. Lo primero de todo es descargar Gentle Net 1.5.0. Yo lo descargue de la web oficial y me dí cuenta que estaba hecho para Visual Studio 2008. Como por aquel entonces no lo tenía, adapte unas cuantas cosas del código para que compilase con VS2005. Si el código no te interesa, bajate la que quieras y coge las librerías y olvidate del código fuente. No obstante yo te dejo aquí el código fuente que he usado en todas las aplicaciones que he realizado.
   
   
2. Una vez descargado lo descomprimimos y nos encontramos con la siguiente estructura de directorios
   
   

Como decía antes, si queremos las librerias, tenemos que acceder a la carpeta Output\Release\ y obtener los siguiente archivos:

• Gentle.Common.dll
• Gentle.Framework.dll
• La libreria que se encarga de la capa de acceso a la base de datos correspondiente.Por ejemplo Gentle.Provider.Jet.

Luego en otro artículo explicaré cosas sobre el código.Por ahora, con tener las librerías basta para hacerlo funcionar.

Ahora que tenemos las 3 librerías necesarias vamos a crear un proyecto e insertarlas. Para ello abrimos nuestro Visual Studio, creamos un proyecto, y agregamos una referencia a estas librerías.

A partir de ahora, ya podemos hacer uso de las librerías en nuestra aplicación.

Con esto sólo tenemos una capa de acceso a la base de datos la cual nos provee de metodos para acceder a los datos, pero si queremos aprovechar la comodidad de Gentle Net, tenemos que generar las clases que nos permiten acceder a los datos de una forma tipo

VersionesObjetos rowObjeto = new VersionesObjetos();
rowObjeto.IdCarpeta = 5;
rowObjeto.Nombre = "UnNombre";
rowObjeto.IdVersionTipo = (int)TiposElementosArbol.Plano;
rowObjeto.Persist();

Es cierto, que algunas veces hay que hacer alguna pequeña modificación a alguna clase para alguna necesidad específica o porque deseamos que el comportamiento sea distinto al que viene por defecto (por ejemplo, en los valores nulos),

Para generar estas clases, primero nos descargamos MyGeneration desde aquí.

Lo instalamos y lo cargamos y si no aparece por defecto, pulsamos sobre Default Settings para configurar lla base de datos a la que nos vamos a conectar. Tiene un aspecto como este

Lo único que tenemos que modificar es la sección de "Connection String" dónde configuraremos la cadena de conexión a nuestra base de datos.

Hay una web donde puedes ver las cadenas de conexión a una gran cantidad de bases de datos en http://www.connectionstrings.com/

Una vez hecho esto, tenemos que cargar la plantilla que  va a generar nuestras clases. Para ello primero nos descargamos la plantilla a utilizar. Pulsa con el boton derecho aquí y selecciona "guardar enlace como "ara descargarla.

Entonces ahora ya podemos darle a Archivo - Abrir y elegir la plantilla. Le damos al boton "ejecutar" para procesar la plantilla.

Se nos mostrará una ventana donde podemos configurar distintos parámetros y donde seleccionaremos las tablas a procesar. Hay que tener en cuenta que si más tarde hacemos un cambio, sólo hay que generar las clases involoucradas en ese cambio, es decir, las que representan la tabla y las tablas relaccionadas.

En este momento, mygeneration se conectará a la base de datos, analizarla las tablas y generará las clases que representan estas tablas. Se genera una clase por tabla.

Ahora ya podemos incluir los archivos generados en nuestro proyecto.

Ahora falta el último paso que sería configurar el Gentle Net para que ataque a la base de datos requerida.

Esto se puede hacer de 2 formas. Una es mediante el archivo Gentle.config, el cual puede estar en varios como veremos en otro artículo, pero lo más fácil es colocarlo por ahora en el directorio de ejecución. La otra forma es mediante código lo cual es indispensable en aplicaciones donde podamos cambiar de base de datos en tiempo de ejecución. Esta última forma la veremos en otro artículo.

Por tanto, cogemos el archivo Gentle.config que viene con el proyecto y en la sección <DefaultProvider configuramos el que nos convenga según la base de datos. En mi caso, una base de datos de access.

<DefaultProvider name="Jet" connectionString="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=&quot;E:\Test.mdb&quot;;OLE DB Services=-1;" />

De todas formas, en el directorio "Documentation" del proyecto Gentle Net (tenéis que bajaros el fuente) encontrareis un pdf donde vienen todos estos parámetros y más cosas.