Comment : créer une classe qui est incluse dans les sauvegardes et restaurations limitées à la configuration
Dernière modification : mercredi 2 février 2011
S’applique à : SharePoint Foundation 2010
Si un composant personnalisé se compose d’informations de configuration que les administrateurs de batterie doivent pouvoir inclure dans les sauvegardes et les restaurations limitées à la configuration, vous devez représenter le composant avec une classe qui implémente l’interface IBackupRestoreConfiguration. Cette rubrique explique comment effectuer cette opération.
Moment auquel implémenter IBackupRestoreConfiguration
La classe de votre composant personnalisé doit implémenter cette interface, et implémenter sa propriété CanBackupRestoreAsConfiguration de manière à ce qu’elle retourne toujours true, si les conditions suivantes sont réunies :
La classe ne représente que des paramètres de configuration.
L’étendue des paramètres englobe la totalité de la batterie de serveurs ou se situe au niveau du service Web de publication de contenu. Pour plus d’informations sur le service Web de publication de contenu, voir Informations de base : entités de service dans Microsoft SharePoint Foundation.
Les paramètres ne supposent aucun nom de serveur particulier, ni aucune topologie de batterie de serveurs particulière.
À l’inverse, votre classe ne doit pas implémenter cette interface si elle représente du contenu, tel que des listes, des sites Web, des collections de sites, des applications Web, des bases de données supplémentaires ou des collections de fichiers autres autre que des fichiers de configuration. Elle de doit pas non plus implémenter cette interface si elle contient des paramètres de configuration liés à des composants de contenu de ce type (ou supposant l’existence de ces derniers). Dans le deuxième cas, la classe doit probablement être implémentée en tant qu’enfant IBackupRestore d’un objet IBackupRestore parent qui représente le contenu.
En règle générale, vous pouvez assimiler une sauvegarde limitée à la configuration à un type de modèle de batterie de serveurs. Une fois que Microsoft SharePoint Foundation a été installé sur une batterie de serveurs, les administrateurs de batterie peuvent restaurer les composants limités à la configuration pour créer un déploiement qui soit configuré en fonction de la batterie de serveurs de source. Ensuite, les administrateurs peuvent éventuellement restaurer tous les composants du contenu d’origine, ou une partie d’entre eux, ou/et ajouter du nouveau contenu. Bien que les composants qui implémentent IBackupRestoreConfiguration puissent prendre part à des restaurations de configuration et de contenu, il est utile d’avoir à l’esprit le scénario modèle de batterie de serveurs au moment de déterminer si un composant doit implémenter IBackupRestoreConfiguration. S’il s’avère opportun que votre composant fasse partie d’un modèle de batterie de serveurs, même si aucun contenu de la batterie de serveurs source n’a été restauré sur une nouvelle batterie de serveurs cible, votre classe doit implémenter IBackupRestoreConfiguration.
Pour implémenter IBackupRestoreConfiguration
Étant donné que IBackupRestoreConfiguration hérite IBackupRestore, consultez d’abord l’introduction de Procédure : créer une classe de contenu qui peut être sauvegardée et restaurée, puis effectuez la procédure « Pour implémenter les membres de IBackupRestore » de cette rubrique. Toutefois, il existe une exception au contenu de cette procédure, en ce sens que la déclaration de classe doit indiquer l’implémentation de IBackupRestoreConfiguration au lieu de IBackupRestore. Voici un exemple :
[GUID("9573FAD9-ED89-45E8-BD8B-6A5034E03895")] public class MyClass : SPPersistedObject, IBackupRestoreConfigurationImplémentez la propriété CanBackupRestoreAsConfiguration afin qu’elle retourne toujours true, comme illustré dans cet exemple.
public bool CanBackupRestoreAsConfiguration { get { return true; } }Revenez à la rubrique Procédure : créer une classe de contenu qui peut être sauvegardée et restaurée et passez à la procédure « Ajouter d’autres membres à votre classe si nécessaire ».
Voir aussi
Tâches
Procédure : créer une classe de contenu qui peut être sauvegardée et restaurée