Gestion des périphériques d'abonné
Les classes SubscriberDevice et SubscriberDeviceEnumeration prennent en charge l'ajout, la mise à jour et la suppression des périphériques cibles utilisés par les abonnés pour recevoir des notifications. Ces classes sont fournies par l'API Notification Services et se trouvent dans l'espace de nomsMicrosoft.SqlServer.NotificationServices.
Un objet SubscriberDevice représente un point de terminaison de remise logique pour les abonnements. Cet objet possède des propriétés pour définir le type de périphérique, le nom, l'adresse et l'abonné. Ces informations sont généralement transmises à l'objet à partir d'une interface de gestion d'abonnement, puis vous utilisez l'objet pour ajouter, mettre à jour ou supprimer l'enregistrement de périphérique d'abonné dans la base de données.
Vous décidez du nombre de périphériques autorisé pour chaque abonné, et de la façon dont la valeur de DeviceName est affectée. Si vous autorisez les abonnés à posséder plusieurs périphériques, vous pouvez les laisser sélectionner leurs propres noms de périphérique. Si vous autorisez les abonnés à ne posséder qu'un seul périphérique, vous pouvez affecter des noms de périphérique standard, basés sur le type de périphérique ou sur un autre critère.
Au moment de la génération de la notification, la règle de génération des notifications doit fournir le nom de périphérique de l'abonné auquel la notification doit être envoyée. Ainsi, la règle doit avoir le moyen de déterminer le nom de périphérique d'abonné à utiliser lors de la génération d'une notification pour un abonnement particulier. Un moyen d'y parvenir consiste à stocker le nom du périphérique d'abonné associé à un abonnement dans les données d'abonnement. Bien qu'il soit courant d'inclure le nom du périphérique d'abonné dans chaque abonnement, cela n'est pas obligatoire. Par exemple, il n'est pas nécessaire de conserver un nom de périphérique dans vos abonnements si votre application livre toujours des notifications par courrier électronique et si vous l'adresse de messagerie des abonnés que vous utilisez correspond à leur ID d'abonné. Dans ce cas, vous pouvez simplement transmettre un nom de périphérique constant tel que « périphérique de messagerie » lorsque vous générez une notification. Vous pouvez décider également de ne pas inclure le nom de périphérique de l'abonné dans un abonnement parce que vous sélectionnez toujours le nom de périphérique dynamiquement lorsque vous générez la notification.
.gif "ms172477.note(fr-fr,SQL.90).gif") Important : |
|---|
| Le nom de périphérique entré par la règle dans l'enregistrement de notification doit correspondre au nom de l'un des périphériques de l'abonné. Si le nom de périphérique fourni dans l'enregistrement de notification ne correspond pas à un enregistrement de périphérique d'abonné valide, le générateur écrit une erreur dans le journal des applications Windows. |
La classe SubscriberDeviceEnumeration représente le jeu de périphériques d'abonnés pour une instance d'abonné ou Notification Services particulière. Vous pouvez sélectionner un périphérique d'abonné spécifique en fournissant son nom de périphérique à l'indexeur d'un objet SubscriberDeviceEnumeration.
Dans cette section
| Rubrique | Description |
|---|---|
Montre comment instancier un objet abonné périphérique. |
|
Montre comment ajouter un périphérique d'abonné à une instance de Notification Services. |
|
Montre comment mettre à jour un enregistrement de périphérique d'abonné existant. |
|
Montre comment supprimer un périphérique d'abonné. |
|
Montre comment remplir une liste avec des canaux de remise. |
Voir aussi
Concepts
API de gestion d'abonnement
Démarrage d'un projet de gestion d'abonnement
Autres ressources
NSSubscriberDeviceView
Gestion des périphériques d'abonné
Gestion des données d'abonnement