Utilizar el ejemplo Subscriber Monitor
La solución Sales Orders Sample incluye dos proyectos adicionales, SubscriberMonitor y SubscriberMonitorUtility. Estos dos proyectos utilizan la compatibilidad de monitor de replicación en Objetos de administración de replicación (RMO). Juntos aportan la funcionalidad para supervisar el estado de la suscripción en el suscriptor local. Se puede obtener acceso al ensamblado SubscriberMonitor.dll a través de otras aplicaciones que se ejecutan en el suscriptor. El programa SubscriberMonitorUtility.exe se ejecuta directamente para mostrar el Subscriber Monitor.
Utilizar el Subscriber Monitor
Para generar y ejecutar el ejemplo Subscriber Monitor Utility
Asegúrese de que están instalados los ejemplos de replicación de SQL Server. Para obtener más información, vea Consideraciones para instalar ejemplos y bases de datos de ejemplo de SQL Server.
Vaya a la ubicación de instalación del ejemplo Subscriber Monitor. La ubicación predeterminada de este ejemplo es C:\Archivos de programa\Microsoft SQL Server\100\Samples\Replication\Merge\CS\SubscriberMonitorUtility.
Abra el archivo de solución SubscriberMonitorUtility.sln en Visual Studio.
Genere la solución.
Ejecute SubscriberMonitorUtility.exe desde la ubicación de generación. La ubicación de generación predeterminada es \bin\debug.
En el cuadro de diálogo Seleccionar suscripción para supervisar, seleccione una instancia de SQL Server en el cuadro desplegable Nombre del servidor local.
Seleccione en el cuadro desplegable Available Subscriptions la suscripción que desee supervisar.
(Opcional) Haga clic en el botón Edit para cambiar las propiedades de la suscripción.
Haga clic en Connect.
Seleccione una sesión de Agente de mezcla de la vista de árbol Merge Sessions.
(Opcional) Haga clic en el botón Actualizar para actualizar la lista de sesión.
Para invocar mediante programación el Suscriptor Monitor
Abra el proyecto Visual Studio que invocará el Suscriptor Monitor.
Agregue una referencia al ensamblado SubscriberMonitor.dll. Este ensamblado se genera como parte de las soluciones SubscriberMonitorUtility.sln o SalesOrders.sln. Para obtener más información sobre cómo generar el ejemplo de pedido de ventas, vea Léame del ejemplo Sales Orders para replicación de mezcla.
(Opcional) Agregar una directiva using (C#) o la instrucción Imports (Visual Basic .NET) para el espacio de nombres Microsoft.Samples.SqlServer.
En su código, cree una instancia de la clase SubscriberMonitor de alguna de las siguientes maneras:
- Pasar el nombre del suscriptor y un objeto SubscriberSubscription que representa la suscripción para supervisar al parámetro subscription.
- Pasar valores en el constructor para los siguientes parámetros que definen una suscripción: subscriber, publication, publisher, publicationDb, subscribery subscriptionDb.
Detalles de implementación
Subscriber Monitor es una aplicación de Windows Forms basada en Microsoft Windows .NET Framework 2.0. La aplicación se inicia ejecutando SubscriberMonitorUtility.exe. Esta aplicación ejecutable crea una instancia de la clase SubscriberMonitor, muestra un cuadro de diálogo que permite al usuario seleccionar la suscripción para supervisar y, a continuación, muestra el formulario de Windows Form. También se pueden crear instancias de la clase SubscriberMonitor a partir de una aplicación de ejemplo. Hay dos métodos de constructor implementados que permiten pasar las propiedades de suscripción durante la creación del nuevo objeto. Estas propiedades también se pueden establecer una vez creado el objeto.
Cuando se utiliza el constructor predeterminado, se muestra un cuadro de diálogo que permite seleccionar la instancia del suscriptor en el equipo local así como la suscripción para supervisar. El cuadro de lista desplegable Nombre del servidor local se rellena con nombres de instancia disponibles devueltos por la propiedad ServerInstances. Cuando se selecciona una instancia del servidor, el cuadro de lista desplegable Suscripciones disponibles se rellena con suscripciones devueltas llamando al método EnumSubscriberSubscriptions.
El ejemplo utiliza la clase MergeSubscriberMonitor para recuperar información de suscripción en el suscriptor y mostrar esta información en el formulario. Cuando se carga el formulario, el método GetSessionsSummary devuelve una matriz de los objetos MergeSessionSummary que representan hasta cinco sesiones de Agente de mezcla anteriores. El control TreeView de Sesiones de mezcla se rellena con estos objetos MergeSessionSummary. Al seleccionar una de las sesiones, se muestra información de resumen sobre la sesión. Asimismo, la matriz de los objetos MergeSessionDetail devuelta por el método GetSessionDetails se muestra en el control ListView Artículos procesados en la sesión .
Para obtener más información sobre cómo utilizar la clase MergeSubscriberMonitor, vea Cómo supervisar la replicación mediante programación (programación con RMO).