CREAR .DLL EN C# PARA USAR EN VFP 9 PASO A PASO (PARTE 1)

MANUAL CREACION .DLL EN C# PARA USAR EN VFP 9.0 (Win 7)

AUTOR : MILTON CACHIPUENDO, Servysistem Online, Ibarra – Ecuador, 0986 104-104

1.       INTRODUCCION

                Luego de realizar una extensa investigación para lograr dar la funcionalidad de Facturación Electrónica (eFactura)  a mi sistema Omega, llegué a definir  el proceso que se necesita para la solución, resumiendo esto: (1) Añadir los campos  necesarios a la Base de Datos, (2) Crear el XML de la factura electrónica, (3) Firmar el XML y (4) enviar al SRI para autorizarlo. Todo bien hasta que me topé con la limitación de que VFP no es un lenguaje que permita ejecutar el proceso de firmar un XML. Afortunadamente encontré una librería denominada FirmaXAdesNet.DLL de licencia GNU desarrollada en España y que permite realizar este trabajo. Pero el problema es que esta librería no es utilizable desde VFP ya que está hecha para entornos de desarrollo de .NET, pero no puede usarse desde VFP porque  requiere sea ensamblada con ciertas particularidades. Por lo que en mi inmenso afán de conocer e implementar mis propias soluciones, me aventuro en crear mi propia librería.

                Para esto tengo que conocer primeramente como crear una librería .DLL en C# que cumpla con los requisitos necesarios para poder usarla desde mi amado Fox. Para esto debo partir desde un conocimiento básico y  en las líneas siguientes detallo un ejemplo sencillo y paso a paso para generar la DLL utilizando Visual Studio 2010 y el lenguaje C#. Posteriormente en otra entrega indicaré como logré firmar el XML de la Factura electrónica para que sea usable en aplicaciones VFP.

                Este ejemplo existe ya en internet, por lo que aunque no detallo los autores por no alargarme mucho procedo a documentarlo paso a paso como lo pude hacerlo, quizá sirva a otros colegas.

2.       CREAR LA DLL

                Este ejemplo fue ejecutado en la plataforma Windows 7, previamente instalado Visual Studio 2010, FrameWork 4.0 de Windows y  Visual Foxpro 9 SP2, una vez que tenemos instalados los requisitos previos ya podemos desarrollar el ejemplo.

                Ingresar  a Visual Studio 2010 ir al menú File, opciones New, Project, se muestra la ventana New Project, en esta ventana navegamos en el árbol de Installed Templates, seleccionamos Visual C#, Windows, de la lista de la derecha seleccionamos Class Library en Name escribimos el nombre de la Clase a crear en nuestro caso la llamaremos VFPMath, en Location indicamos la ruta donde se creará el proyecto que será C:\VFPMath, luego OK.

                A la derecha en el árbol del proyecto buscar Class1.cs y reemplazar el siguiente código que seguidamente procederé a describir.

* * *

using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Runtime.InteropServices; namespace VFPMATH {     [ClassInterface(ClassInterfaceType.AutoDual)]     [ProgId("VFPMath.MathFunctions")]     public class MathFunctions :  System.EnterpriseServices.ServicedComponent {         public Int32 Add(Int32 x, Int32 y) { return(x + y);}         public Int32 Subtract(Int32 x, Int32 y) { return(x - y);}         public Int32 Multiply(Int32 x, Int32 y) { return(x * y);}         public Int32 Divide(Int32 x, Int32 y) { return(x / y);}     } }

*  Son líneas que no pueden excluirse para usar desde VFP.

                Considero que el lector es un programador de nivel medio que tiene algo de experiencia en programación C#, por lo que será muy obvio las líneas de código anteriores, en resumen se crea una DLL llamada VFPMath, que implementa una Clase pública llamada MathFunctions, que tiene varios métodos públicos  (Add, Substract, Multiply y Divide) que realizan las operaciones matemáticas indicadas.

                Vemos una estructura propia para crear un objeto COM por lo que las línea  (using System.Runtime.InteropServices;) es requisito y no puede excluirse. Las líneas que prosiguen a namespace siempre debe estructurarse así, es decir la clase MathFunctions debe estar dentro del namespace. Tampoco se pueden excluir los atributos ([ClassInterface(ClassInterfaceType.AutoDual)] y [ProgId("VFPMath.MathFunctions")]), con esto ya tenemos todo el código que requerimos para el ejemplo.

                Lo siguiente es establecer unas dos propiedades adicionales y listo, para esto en Solution Explorer abrimos el menú de contexto de  C# VFPMath y escogemos Properties, en la pestaña Application hacemos click en Assembly Information… en la ventana que se abrió activamos la casilla Make Assembly COM-Visible.

                En la pestaña Signing (firmando) seleccione activamos la casilla Sign the Assembly, en el combo box seleccione New…, al abrirse la siguiente ventana de una nombre al archivo de firma en nuestro caso será VFPMath, desactive la opción Protect my key file with a password, luego OK.

               

En Solution Explorer abrimos el menú de contexto de References, seleccionamos Add Reference… , en la pestaña .NET, buscamos System.EnterpriseServices y luego OK, como muestra en la figura de la siguiente página.

Con esto está lista nuestra DLL, para generarla en Solution Explorer abrimos el menú de contexto de  Solution VFPMath  y seleccionamos la opción Built Solution. Ahora nuestra solución se encuentra en el directorio: c:\VFPMath\ VFPMath\ VFPMath\Bin\Debug.

3.       REGISTRAR LA DLL

                Ahora busco el archivo RegAsm.exe,  lo he localice en el siguiente directorio  C:\Windows\Microsoft.NET\Framework\v4.0.30319  procedo a copiar al directorio donde se creó mi  VFPMath.DLL, esto es en la carpeta C:\VFPMath\ VFPMath\ VFPMath\Bin\Debug. En este punto ya puedo registrar la librería, ejecuto como Administrador del Sistema el Símbolo del Sistema y luego el siguiente comando:

RegAsm VFPMath.dll /codebase

4.       USANDO LA LIBRERÍA DESDE VFP.

Una vez que está registrada esta librería estará disponible en cualquier momento y podemos ahora usarla, con el siguiente código fox podemos hacerlo, creamos el programa VFPMath.PRG, y seguidamente lo ejecutamos.

oVFPMath = CreateObject("VFPMath.MathFunctions")

?oVFPMath.add(5,4)

?oVFPMath.subtract(5,4)

?oVFPMath.multiply(5,4)

?oVFPMath.divide(5,4)