Compartir a través de


Registrar componentes con servicio

Un componente con servicio se aloja en una aplicación COM+ y debe estar accesible para esa aplicación. En cuanto a accesibilidad, los componentes con servicio tienen los siguientes requisitos de registro y configuración:

  • El ensamblado debe tener un nombre seguro. Para obtener más información, vea Firmar un ensamblado con un nombre seguro.

  • El ensamblado debe estar registrado en el Registro de Windows.

  • Es necesario registrar e instalar definiciones de bibliotecas de tipos en una aplicación COM+ concreta.

  • Los servicios agregados mediante programación se deben configurar en el catálogo de COM+.

La información de registro útil para los componentes con servicio es la siguiente:

  • Identidad de la aplicación COM+

  • Tipo de activación

  • Información de descripción

Identidad de la aplicación COM+

Una aplicación COM+ de destino existente se puede identificar por nombre o por GUID. La herramienta Instalación de servicios de .NET (Regsvcs.exe) proporciona la opción /appname: para especificar el nombre de la aplicación.

Para obtener información acerca de cómo especificar un nombre de aplicación, vea Cómo establecer el nombre de la aplicación mediante el uso del atributo ApplicationName.

Si se aplica el atributo ApplicationID (o el atributo Guid) a un ensamblado, todas las búsquedas de la aplicación se basan en ese GUID y no en el nombre de la aplicación.

Para obtener información acerca de cómo especificar un Id. de aplicación, vea Cómo aplicar el atributo ApplicationID a un ensamblado.

Nota:

En el registro dinámico, la única manera de especificar una aplicación de destino es la de aplicar los atributos ApplicationNameAttribute, ApplicationIDAttribute o GuidAttribute en el momento del diseño. La herramienta Instalación de servicios de .NET (Regsvcs.exe) proporciona el modificador /appname: para especificar el nombre de la aplicación o el GUID en el momento de la compilación. Regsvcs.exe proporciona también el modificador /parname: para identificar una partición COM+ concreta. El servicio de particiones COM+ sólo está disponible en las plataformas Windows Server 2003.

Si no se identifica o no se encuentra la aplicación de destino, los mecanismos de registro crean una aplicación usando el nombre completo del ensamblado sin el número de versión.

Precaución:

No utilice el atributo ApplicationIDAttribute con el servicio de particiones COM+. Si está utilizando el servicio de particiones COM+, el hecho de aplicar el atributo ApplicationIDAttribute impide la configuración de la partición. El servicio de particiones COM+ sólo está disponible en las plataformas Windows Server 2003.

Tipo de activación

El tipo de activación determina en qué proceso se crean los componentes con servicio. Para especificar el tipo de activación, se puede aplicar el atributo ApplicationActivationAttribute a un ensamblado. El atributo ApplicationActivationAttribute se debe declarar con uno de los dos valores de enumeración siguientes:

  • ActivationOption.Library: especifica una aplicación de biblioteca COM+; los componentes con servicio del ensamblado se activan en el proceso del llamador.

  • ActivationOption.Server: especifica una aplicación de servidor COM+; los componentes con servicio del ensamblado se activan en un nuevo proceso suministrado por el sistema.

Nota:

Para obtener información acerca de cómo establecer el tipo de activación de una aplicación, vea Cómo establecer el tipo de activación de una aplicación.

Nota:

Si el atributo ApplicationActivationAttribute se establece en ActivationOption.Server, se ha de agregar el ensamblado y cualquier ensamblado del que dependa a la caché de ensamblados global (GAC) mediante Windows Installer, para poder usar la nueva aplicación de servidor; en caso contrario, la aplicación generará una excepción. Además, si el atributo ApplicationActivationAttribute se establece en ApplicationOption.Server, los parámetros de componentes con servicio se deben marcar como System.Serializable o derivarse de la clase System.MarshalByRefObject. Si no, la aplicación genera una excepción.

Información de descripción

Una descripción es opcional, pero a veces resulta útil para distinguir ensamblados parecidos.

Para obtener información acerca de cómo establecer el tipo de activación de una aplicación, vea Cómo aplicar el atributo Discription a un ensamblado.

Los temas que siguen en esta sección describen los mecanismos de registro para implementar aplicaciones que usan los servicios COM+:

Los dos mecanismos de registro simplifican el proceso de registro combinando los pasos necesarios para registrar un componente con servicio. Los dos requieren que el usuario del componente sea miembro del grupo de los administradores. Para el registro dinámico, se puede proporcionar la información de registro en el momento del diseño y, parte, en el momento de la compilación. Para el registro manual, se puede proporcionar esta información en tiempo de diseño, en tiempo de compilación y en tiempo de registro. Si se omite la información de registro, el proceso de registro genera sus propios metadatos. El proceso de registro detecta y, a veces, corrige combinaciones de atributos incompatibles.

Consulte también

Tareas

Cómo crear un componente con servicio

Referencia

ApplicationNameAttribute
ApplicationIDAttribute
GuidAttribute
ApplicationActivationAttribute
DescriptionAttribute
System.EnterpriseServices Namespace

Conceptos

Información general sobre componentes con servicio
Aplicar atributos para configurar servicios COM+
Ejemplo de componente con servicio
Resumen de los servicios COM+ disponibles

Otros recursos

Escribir componentes con servicio
Extending Metadata Using Attributes

Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.