Tutorial: Crear objetos COM con Visual Basic

  • Artículo

Al crear nuevas aplicaciones o componentes, es mejor crear ensamblados de .NET Framework. Sin embargo, Visual Basic también facilita la exposición de un componente de .NET Framework a COM. Esto le permite proporcionar nuevos componentes para conjuntos de aplicaciones anteriores que requieren componentes COM. En este tutorial se muestra cómo usar Visual Basic para exponer objetos de .NET Framework como objetos COM mediante la plantilla de clase COM o sin ella.

La manera más fácil de exponer objetos COM es mediante la plantilla de clase COM. Esta plantilla crea una nueva clase y, a continuación, configura el proyecto para que genere la clase con una capa de interoperabilidad como un objeto COM y la registre con el sistema operativo.

Nota

Aunque también puede exponer una clase creada en Visual Basic como un objeto COM para que la use el código no administrado, no es un objeto COM verdadero y Visual Basic no lo puede usar. Para más información, consulte Interoperabilidad COM en aplicaciones de .NET Framework.

Nota:

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Personalizar el IDE.

Para crear un objeto COM mediante la plantilla de clase COM

  1. Abra un nuevo proyecto de aplicación de Windows en el menú Archivo haciendo clic en Nuevo proyecto.

  2. En el cuadro de diálogo Nuevo proyecto debajo del campo Tipos de proyecto, compruebe que Windows está seleccionado. Seleccione Biblioteca de clases en la lista Plantillas y, a continuación, haga clic en Aceptar. El nuevo proyecto se abre.

  3. Seleccione Agregar elemento nuevo 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 como propiedades, métodos y eventos a la clase COM.

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

Creación de objetos COM sin la plantilla de clase COM

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

Para configurar el proyecto para generar un objeto COM

  1. Abra un nuevo proyecto de aplicación de Windows en el menú Archivo haciendo clic en Nuevo Proyecto.

  2. En el cuadro de diálogo Nuevo proyecto debajo del campo Tipos de proyecto, compruebe que Windows está seleccionado. Seleccione Biblioteca de clases en la lista Plantillas y, a continuación, haga clic en Aceptar. El nuevo proyecto se abre.

  3. En el Explorador de soluciones, haga clic con el botón derecho del mouse en su proyecto y después seleccione Propiedades. Aparece el Diseñador de proyectos.

  4. Haga clic en la pestaña Compilar.

  5. Active la casilla Registrar para interoperabilidad COM.

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

  1. En Explorador de soluciones, haga doble clic en Class1.vb para que aparezca su código.

  2. Cambie el nombre de la clase a ComClass1.

  3. Agregue las constantes siguientes a ComClass1. Almacenarán las constantes de identificador único global (GUID) que los objetos COM deben tener.

    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 de Registro y luego en Copiar. Haga clic en Salir.

  5. Reemplace la cadena vacía del ClassId por el GUID, quitando las llaves iniciales y finales. Por ejemplo, si el GUID proporcionado por Guidgen es "{2C8B0AEE-02C9-486e-B809-C780A11530FE}", el código debe aparecer de la siguiente manera.

    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 del identificador de clase, de interfaz y de eventos, como en el ejemplo siguiente:

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

  8. Las clases COM deben tener un constructor Public Sub New() sin parámetros o 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, finalizando con una instrucción End Class. En el menú Compilar, seleccione Compilar solución. Visual Basic compila el ensamblado y registra el objeto COM con el sistema operativo.

    Nota

    Los objetos COM que se generan con Visual Basic no se pueden usar en otras aplicaciones de Visual Basic porque no son verdaderos objetos COM. Los intentos de agregar referencias a estos objetos COM producirán un error. Para más información, consulte Interoperabilidad COM en aplicaciones .NET Framework.

Consulte también