Verwalten von Abonnentengeräten
Die Klassen SubscriberDevice und SubscriberDeviceEnumeration unterstützen das Hinzufügen, Aktualisieren und Löschen der Zielgeräte, die Abonnenten für den Empfang von Benachrichtigungen verwenden. Diese Klassen werden von der Notification Services-API bereitgestellt und befinden sich im Microsoft.SqlServer.NotificationServices-Namespace.
Ein SubscriberDevice-Objekt stellt einen logischen Übermittlungsendpunkt für Abonnements dar. Dieses Objekt verfügt über Eigenschaften für das Festlegen des Gerätetyps, des Namens, der Adresse und des Abonnenten. Diese Informationen werden normalerweise von einer Abonnementverwaltungsschnittstelle an das Objekt übergeben. Anschließend verwenden Sie das Objekt, um den Abonnentengerät-Datensatz in der Datenbank hinzuzufügen, zu aktualisieren oder zu entfernen.
Sie entscheiden, über wie viele Geräte jeder Abonnent verfügen kann und wie der Wert von DeviceName zugewiesen wird. Wenn Sie es Abonnenten ermöglichen, über mehr als ein Gerät zu verfügen, möchten Sie möglicherweise, dass die Abonnenten eigene Gerätenamen auswählen. Wenn Sie es Abonnenten ermöglichen, über nur ein Gerät zu verfügen, möchten Sie möglicherweise Standardgerätenamen auf der Basis des Gerätetyps oder eines anderen Kriteriums zuweisen.
Zum Zeitpunkt des Generierens von Benachrichtigungen muss die Benachrichtigungsgenerierungsregel den Abonnentengerätenamen bereitstellen, an den die Benachrichtigung gesendet werden soll. Daher muss die Regel eine Möglichkeit haben, zu bestimmen, welcher Abonnentengerätename beim Generieren einer Benachrichtigung für ein bestimmtes Abonnement verwendet werden soll. Eine dieser Möglichkeiten besteht darin, den einem Abonnement zugeordneten Abonnentengerätenamen in den Abonnementdaten zu speichern. Obwohl das Einschließen des Abonnentengerätenamens in jedes Abonnement üblich ist, ist es nicht erforderlich. Beispielsweise ist es nicht erforderlich, einen Gerätenamen in Abonnements zu speichern, wenn die Anwendung Benachrichtigungen immer per E-Mail übermittelt und Sie die E-Mail-Adresse des Abonnenten als seine Abonnenten-ID verwenden. In diesem Fall können Sie beim Generieren einer Benachrichtigung einfach einen konstanten Gerätenamen übergeben, wie z. B. "E-Mail-Gerät". Alternativ können Sie sich entscheiden, den Gerätenamen des Abonnenten nicht in ein Abonnement einzuschließen, da Sie den Gerätenamen immer dynamisch auswählen, wenn Sie die Benachrichtigung generieren.
Wichtig: |
---|
Der Gerätename, der von der Regel im Benachrichtigungsdatensatz eingegeben wird, muss dem Namen eines der Geräte des Abonnenten entsprechen. Wenn der im Benachrichtigungsdatensatz angegebene Gerätename nicht mit einem gültigen Abonnentengerät-Datensatz übereinstimmt, schreibt der Generator einen Fehler in das Windows-Anwendungsprotokoll. |
Die SubscriberDeviceEnumeration-Klasse stellt den Satz der Abonnentengeräte für einen bestimmten Abonnenten oder eine bestimmte Notification Services-Instanz dar. Sie können ein bestimmtes Abonnentengerät auswählen, indem Sie seinen Gerätenamen der Indexerstellung eines SubscriberDeviceEnumeration-Objekts bereitstellen.
In diesem Abschnitt
Thema | Beschreibung |
---|---|
Zeigt, wie ein Abonnentengeräteobjekt instanziiert wird. |
|
Zeigt, wie einer Instanz von Notification Services ein Abonnentengerät hinzugefügt wird. |
|
Zeigt, wie ein vorhandener Abonnentengerät-Datensatz aktualisiert wird. |
|
Zeigt, wie ein Abonnentengerät gelöscht wird. |
|
Zeigt, wie eine Liste mit Übermittlungskanälen aufgefüllt wird. |
Siehe auch
Konzepte
Abonnementverwaltungs-API
Starten eines Abonnementverwaltungsprojekts
Andere Ressourcen
NSSubscriberDeviceView
Verwalten von Abonnentengeräten
Verwalten von Abonnementdaten