Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Actualización: noviembre 2007
En este ejemplo se muestra el uso de cadenas de construcción de objetos en un entorno .NET. Las cadenas de construcción de objetos son cadenas de inicialización que se pueden especificar o modificar mediante la herramienta administrativa Servicios de componente, eliminando la necesidad de integrar como parte del código la información de configuración dentro de los componentes. La interfaz de usuario del ejemplo es un formulario con un botón, que crea un objeto que utiliza cadenas de construcción. Los cuadros de mensaje muestran las diversas etapas de activación.
Para obtener información sobre el uso de los ejemplos, vea los siguientes temas:
Para generar el ejemplo desde el símbolo del sistema
Abra la ventana del símbolo del sistema y navegue hasta uno de los subdirectorios específicos de un lenguaje bajo el directorio Technologies\ComponentServices\ObjectConstruction.
Escriba msbuild ObjectConstructionCS.sln o msbuild ObjectConstructionVB.sln, dependiendo del lenguaje de programación elegido.
Para generar el ejemplo mediante Visual Studio
Abra el Explorador de Windows y navegue hasta uno de los subdirectorios específicos de un lenguaje bajo el directorio Technologies\ComponentServices\ObjectConstruction.
Haga doble clic en el icono de ObjectConstructionCS.sln o de ObjectConstructionVB.sln, dependiendo del lenguaje de programación elegido, para abrir el archivo en Visual Studio.
En el menú Generar, haga clic en Generar solución.
Para ejecutar el ejemplo
Abra la ventana del símbolo del sistema o el Explorador de Windows y navegue hasta el directorio que contiene el archivo ejecutable generado.
Escriba OCDemo.exe en la línea de comandos o inicie el archivo ejecutable haciendo doble clic en él en el Explorador de Windows. Tenga en cuenta si está ejecutando la versión de C# (en el subdirectorio \CS) o de Visual Basic (en el subdirectorio \VB) de la aplicación de ejemplo, ya que esto determinará qué atributos del componente COM+ modificará en un paso posterior.
Cuando el programa se inicie, haga clic en el botón denominado Create Object. Aparecerá un cuadro de mensaje en cada fase de activación. Observe el valor de la cadena de construcción del objeto indicado en la llamada a IObjectConstruct::Construct.
Inicie la herramienta administrativa Servicios de componente haciendo clic en Inicio -> Todos los programas -> Herramientas administrativas -> Servicios de componente, y busque la aplicación OCDemoSvr COM+ expandiendo Servicios de componente\Equipos\Mi PC\Aplicaciones COM+ en el panel izquierdo del explorador.
Busque el componente Microsoft.Samples.Technologies.ComponentServices.ObjectConstruction.ObjectConstructionTest expandiendo OCDemoSvr\Components.
Haga clic con el botón secundario en el componente ObjectConstructionTest y seleccione Propiedades en el menú emergente.
Haga clic en la ficha Activación y especifique un nuevo valor de texto en el campo de edición de cadenas Constructor. Haga clic en Aceptar para aceptar el cambio.
Vuelva a la aplicación OCDemo y haga clic de nuevo en Create Object. Tome nota del nuevo valor indicado por el método IObjectConstruct (debe coincidir con la cadena recién editada de la página de propiedades del componente del explorador COM+).
Para desinstalar el ejemplo
Navegue hasta el directorio donde ejecutó msbuild.exe o abrió el archivo .sln.
Escriba msbuild.exe ObjectConstructionVB.sln /t:Clean o msbuild.exe ObjectConstructionCS.sln /t:Clean, en función del lenguaje de programación elegido, en la línea de comandos. De este modo se llama a Herramienta Instalación de servicios de .NET (Regsvcs.exe) y a Herramienta Caché de ensamblados global (Gacutil.exe) con el modificador /u para eliminar los archivos de ejemplo del catálogo COM+ y de la caché de ensamblados global.
Requisitos
Plataformas: Windows 2000, Windows XP, Windows Server 2003
Versión de .NET Framework: 2.0, 1.1, 1.0
Comentarios
Para obtener más información sobre la creación binaria de ejemplos y los pasos del registro, revise los comentarios en los archivos de código fuente.
En este procedimiento se muestra cómo crear un componente COM+ con la construcción de objetos habilitada y utilizando una cadena de construcción predeterminada. Al crear una instancia de objeto, varios métodos de componente muestran cuadros de mensaje para mostrar el orden de la llamada. Se puede modificar la cadena de construcción de objetos utilizando la herramienta administrativa Servicios de componente y volviendo a ejecutar el ejemplo para ver cómo cambia la cadena de construcción de objetos pasada a la instancia del componente.
.gif "Nota") Nota: |
|---|
Debe utilizar Herramienta Caché de ensamblados global (Gacutil.exe) para instalar el ensamblado OCDemoSvr.dll en la caché de ensamblados global antes de ejecutar el ejemplo. Gacutil.exe se encuentra en el directorio SDK \<versión>\Bin. Por ejemplo, si ha generado la versión de Visual Basic del ejemplo, navegue hasta el directorio C:\Documents and Settings\nombre de usuario\Mis documentos\Samples\Technologies\ComponentServices\ObjectConstruction\VB y escriba gacutil -i OCDemoSvr.dll. |
El nombre del componente que se ve en la herramienta administrativa Servicios de componente es Microsoft.Samples.Technologies.ComponentServices.ObjectConstruction.ObjectConstructionTest.
Cuando se habilita la construcción de objetos para un componente, COM+ llama e implementa el método IObjectContruct::Construct inmediatamente después de crear una instancia del objeto. La cadena de construcción de objetos especificada en las propiedades de activación del componente se pasa como un argumento al método. Esto, en combinación con el código de componente que utiliza correctamente la cadena de objetos, proporciona eficazmente la construcción de objetos parametrizada.
Puede especificar un valor de cadena predeterminado para la cadena de construcción en la propiedad Predeterminado del atributo ConstructionEnabledAttribute, en el catálogo de COM+, o en ambos.
Un desarrollador de componentes podría utilizar esta característica para, por ejemplo, escribir un componente que contiene una conexión ODBC genérica. La cadena de construcción de objetos contendría un DSN exacto que se podría cambiar a través de la herramienta administrativa Servicios de componente.
Las cadenas de construcción de objetos pueden ser útiles en combinación con los servicios de agrupación de objetos COM+.
Vea también
Conceptos
Utilizar tipos COM en código administrado
Referencia
Herramienta Caché de ensamblados global (Gacutil.exe)