Verwenden des Subscriber Monitor-Beispiels
Die Projektmappe Sales Orders-Beispiel umfasst zwei zusätzliche Projekte: SubscriberMonitor und SubscriberMonitorUtility. Diese Projekte verwenden gemeinsam die Replikationsmonitorunterstützung in den Replikationsverwaltungsobjekten (RMO), um Funktionen zur Überwachung des Abonnementstatus auf dem lokalen Abonnenten bereitzustellen. Die Assembly SubscriberMonitor.dll ist für andere Anwendungen zugänglich, die auf dem Abonnenten ausgeführt werden, und das Programm SubscriberMonitorUtility.exe wird direkt ausgeführt, um den Subscriber Monitor anzuzeigen.
Verwenden von Subscriber Monitor
So erstellen Sie das Subscriber Monitor Utility-Beispiel und führen es aus
Stellen Sie sicher, dass die SQL Server-Replikationsbeispiele installiert sind. Weitere Informationen finden Sie unter Überlegungen zum Installieren der SQL Server-Beispiele und -Beispieldatenbanken.
Navigieren Sie zum Installationsverzeichnis des Subscriber Monitor-Beispiels. Der Standardspeicherort für dieses Beispiel ist C:\Programme\Microsoft SQL Server\100\Samples\Replication\ Merge\CS\SubscriberMonitorUtility.
Öffnen Sie die Projektmappendatei SubscriberMonitorUtility.sln in Visual Studio.
Erstellen Sie die Projektmappe.
Führen Sie SubscriberMonitorUtility.exe vom Buildspeicherort aus. Der Standard-Buildspeicherort ist \bin\debug.
Wählen Sie im Dialogfeld Select Subscription to Monitor im Dropdownfeld Local Server Name eine Instanz von SQL Server aus.
Wählen Sie im Dropdown-Listenfeld Available Subscriptions ein zu überwachendes Abonnement aus.
(Optional) Klicken Sie auf die Schaltfläche Edit, um die Abonnementeigenschaften zu ändern.
Klicken Sie auf Connect.
Wählen Sie in der Strukturansicht Merge Sessions eine Merge-Agentsitzung aus.
(Optional) Klicken Sie auf die Schaltfläche Refresh, um die Sitzungsliste zu aktualisieren.
So rufen Sie Subscriber Monitor programmgesteuert auf
Öffnen Sie das Visual Studio-Projekt, das Subscriber Monitor aufruft.
Fügen Sie der Assembly SubscriberMonitor.dll einen Verweis hinzu. Diese Assembly wird als Teil der SubscriberMonitorUtility.sln- oder SalesOrders.sln-Projektmappe erstellt. Weitere Informationen zum Erstellen des Sales Orders-Beispiels finden Sie unter Readme_Sales Orders-Beispiel für die Mergereplikation.
(Optional) Fügen Sie eine using-Direktive (C#) oder eine Imports-Anweisung (Visual Basic .NET) für den Microsoft.Samples.SqlServer-Namespace hinzu.
Erstellen Sie mithilfe einer der folgenden Methoden im Code eine Instanz der SubscriberMonitor-Klasse:
- Übergabe des Abonnentennamens und eines SubscriberSubscription-Objekts, dass das zu überwachende Abonnement darstellt, an den subscription-Parameter.
- Übergabe von Werten in den Konstruktor für folgende Parameter, die ein Abonnement definieren: subscriber, publication, publisher, publicationDb, subscriber und subscriptionDb.
Implementierungsdetails
Subscriber Monitor ist eine Windows Forms-Anwendung auf Grundlage von Microsoft Windows .NET Framework 2.0. Die Anwendung wird gestartet, indem man SubscriberMonitorUtility.exe ausführt. Diese ausführbare Datei erstellt eine Instanz der SubscriberMonitor-Klasse, zeigt einen Dialog an, in dem der Benutzer das zu überwachende Abonnement auswählen kann, und zeigt dann das Windows Form an. Die SubscriberMonitor-Klasse kann auch von einer Beispielanwendung instanziiert werden. Zwei implementierte Konstruktormethoden ermöglichen es Ihnen, Abonnementeigenschaften während der Erstellung eines neuen Objekts zu übergeben. Diese Eigenschaften können auch nach der Erstellung des Objekts festgelegt werden.
Bei Verwendung des Standardkonstruktors wird ein Dialogfeld angezeigt, in dem Sie sowohl die Subscriber-Instanz auf dem lokalen Computer als auch das zu überwachende Abonnement auswählen können. Im Local Server Name-Dropdown-Listenfeld werden die verfügbaren Instanzennamen angezeigt, die von der ServerInstances-Eigenschaft zurückgegeben wurden. Wenn eine Serverinstanz ausgewählt ist, werden im Available Subscriptions-Dropdown-Listenfeld die Abonnements angezeigt, die durch Aufrufen der EnumSubscriberSubscriptions-Methode zurückgegeben werden.
Das Beispiel verwendet die MergeSubscriberMonitor-Klasse, um Abonnementinformationen vom Abonnenten abzurufen, und zeigt diese Informationen im Formular an. Wenn das Formular geladen wird, gibt die GetSessionsSummary-Methode ein Array von MergeSessionSummary-Objekten zurück, die bis zu fünf vorhergehende Sitzungen des Merge-Agent darstellen. Das Merge Sessions TreeView-Steuerelement wird mit diesen MergeSessionSummary-Objekten aufgefüllt. Wenn Sie eine der Sitzungen auswählen, wird eine Zusammenfassung der Sitzungsinformationen angezeigt. Außerdem wird das von der GetSessionDetails-Methode zurückgegebene Array von MergeSessionDetail-Objekten im Articles processed in session ListView-Steuerelement angezeigt.
Weitere Informationen über das Programmieren mit der MergeSubscriberMonitor-Klasse finden Sie unter Vorgehensweise: Programmgesteuertes Überwachen der Replikation (RMO-Programmierung).