Tutorial: Crear objetos COM con Visual Basic

Cuando se crean nuevas aplicaciones o componentes, es mejor crear ensamblados de .NET Framework. No obstante, Visual Basic facilita también la exposición de un componente de .NET Framework en COM. De esta manera, puede proporcionar nuevos componentes para conjuntos de aplicaciones anteriores que requieren componentes COM. En este tutorial se muestra cómo utilizar Visual Basic para exponer los objetos de .NET Framework como objetos COM, tanto con la plantilla de clase COM como sin ella.

El modo más sencillo de exponer un objeto COM es utilizar la plantilla de clase COM. Esta plantilla crea una clase nueva y, a continuación, configura el proyecto para generar la clase y el nivel de interoperabilidad como un objeto COM y registra este objeto en el sistema operativo.

Para crear un objeto COM mediante la plantilla de clase COM

1. Abra un nuevo proyecto de aplicación para Windows en el menú Archivo; para ello, haga clic en Nuevo proyecto.

2. En el cuadro de diálogo Nuevo proyecto, situado bajo el campo Tipos de proyecto, compruebe que se ha seleccionado Windows. Seleccione Biblioteca de clases en la lista Plantillas y, a continuación, haga clic en Aceptar. Aparecerá el proyecto nuevo.

3. Seleccione Agregar nuevo elemento en el menú Proyecto. Se abrirá el cuadro de diálogo Agregar nuevo elemento.

4. Seleccione Clase COM en la lista Plantillas y, a continuación, haga clic en Agregar. Visual Basic agrega una nueva clase y configura el nuevo proyecto para la interoperabilidad COM.

5. Agregue código a la clase COM, como propiedades, métodos y eventos.

6. Seleccione Generar ClassLibrary1 en el menú Generar. Visual Basic compila el ensamblado y registra el objeto COM con el sistema operativo.

Crear objetos COM sin la plantilla de clase COM

También puede crear una clase COM manualmente en lugar de utilizar la plantilla de clase COM. Este procedimiento resulta útil cuando se trabaja desde la línea de comandos o cuando se desea lograr más control sobre la definición de los objetos COM.

Para configurar el proyecto para generar un objeto COM

1. Abra un nuevo proyecto de aplicación para Windows desde el menú Archivo; para ello, haga clic en Nuevo proyecto.

2. En el cuadro de diálogo Nuevo proyecto, situado bajo el campo Tipos de proyecto, compruebe que se ha seleccionado Windows. Seleccione Biblioteca de clases en la lista Plantillas y, a continuación, haga clic en Aceptar. Aparecerá el proyecto nuevo.

3. En el Explorador de soluciones, haga clic con el botón secundario del mouse en su proyecto y, a continuación, seleccione Propiedades. Se mostrará el Diseñador de proyectos.

4. Haga clic en la ficha Compilar.

5. Active la casilla Registrar para interoperabilidad COM.

Para configurar el código de la clase para crear un objeto COM

1. En el Explorador de soluciones, haga doble clic en Class1.vb para mostrar el código que contiene.

2. Cambie el nombre de la clase a ComClass1.

3. Agregue a ComClass1 las constantes que se especifican a continuación. Estas constantes almacenarán las constantes de identificador único global (GUID) que necesitan los objetos COM.

   Public Const ClassId As String = ""
   Public Const InterfaceId As String = ""
   Public Const EventsId As String = ""
   

4. En el menú Herramientas, haga clic en Crear GUID. En el cuadro de diálogo Crear GUID, haga clic en Formato del Registro y, a continuación, en Copiar. Haga clic en Salir.

5. Reemplace la cadena vacía de ClassId con el GUID, y quite las llaves de apertura y cierre. Por ejemplo, si el GUID proporcionado por Guidgen es "{2C8B0AEE-02C9-486e-B809-C780A11530FE}", el código debería aparecer como se muestra a continuación.

   Public Const ClassId As String = "2C8B0AEE-02C9-486e-B809-C780A11530FE"
   

6. Repita los pasos anteriores para las constantes InterfaceId y EventsId, como en el ejemplo siguiente.

   Public Const InterfaceId As String = "3D8B5BA4-FB8C-5ff8-8468-11BF6BD5CF91"
   Public Const EventsId As String = "2B691787-6ED7-401e-90A4-B3B9C0360E31"
   

   Nota

   Asegúrese de que los GUID son nuevos y únicos; de lo contrario, el componente COM podría entrar en conflicto con otros componentes COM.

7. Agregue el atributo ComClass a ComClass1, especificando los GUID correspondientes al Id. de clase, al Id. de interfaz y a los Id. de eventos, como en el siguiente ejemplo:

   <ComClass(ComClass1.ClassId, ComClass1.InterfaceId, ComClass1.EventsId)>
   Public Class ComClass1
   

8. Las clases COM deben tener un constructor Public Sub New() sin parámetros; de lo contrario, la clase no se registrará correctamente. Agregue un constructor sin parámetros a la clase:

   Public Sub New()
       MyBase.New()
   End Sub
   

9. Agregue propiedades, métodos y eventos a la clase, y agregue la instrucción End Class al final. En el menú Generar, seleccione Generar solución . Visual Basic compila el ensamblado y registra el objeto COM con el sistema operativo.

   Nota

   Los objetos COM que genere con Visual Basic no se pueden utilizar en otras aplicaciones de Visual Basic porque no son auténticos objetos COM. Si intenta agregar referencias a estos objetos COM se producirá un error. Para obtener información detallada, vea Interoperabilidad COM en aplicaciones .NET Framework (Visual Basic).

Vea también

Tareas

Tutorial: Implementar la herencia mediante objetos COM (Visual Basic)

Solucionar problemas de interoperabilidad (Visual Basic)

Referencia

ComClassAttribute

#Region (Directiva)

Otros recursos

Interoperabilidad COM (Visual Basic)

Interoperabilidad COM en aplicaciones .NET Framework (Visual Basic)