Ajouter un onglet aux paramètres

Article
08/29/2023

S’applique à : Windows Server 2016 Essentials, Windows Server 2012 R2 Essentials, Windows Server 2012 Essentials

Vous pouvez ajouter un onglet aux Paramètres dans le Tableau de bord en créant et en installant un assembly de code utilisé par le Gestionnaire des paramètres dans le système d'exploitation.

Ajouter un onglet aux Paramètres

Vous ajoutez un onglet aux paramètres en exécutant les tâches suivantes :

Ajout d’une implémentation de l’interface ISettingsData à l’assembly

L’interface ISettingsData fait partie de l’espace de noms Microsoft.WindowsServerSolutions.Settings de l’assembly AdminCommon.dll, lequel figure dans \Program Files\Windows Server\Bin.

Pour ajouter le code ISettingsData à l’assembly

Ouvrez Visual Studio 2010 en tant qu’administrateur en cliquant avec le bouton droit sur le programme dans le menu Démarrer, puis en sélectionnant Exécuter en tant qu’administrateur.
Cliquez sur Fichier, sur Nouveau, puis sur Projet.
Dans la boîte de dialogue Nouveau projet, cliquez sur Visual C# puis sur Bibliothèque de classes, donnez le nom DashboardSettingsPage à la solution, puis cliquez sur OK.

Important

L’assembly installé sur le serveur doit être nommé DashboardSettingsPage.dll et le fichier dll doit être copié sur %ProgramFiles%\Windows Server\Bin\OEM.
Créez le contrôle que vous souhaitez utiliser dans l’onglet . Dans cet exemple, le contrôle des paramètres s’appelle MySettingsControl.
Renommez le fichier Class1.cs. Appelez-le, par exemple, MySettingTab.cs.
Ajoutez une référence au fichier AdminCommon.dll.

Ajoutez les instructions using suivantes :

using Microsoft.WindowsServerSolutions.Settings;

Changez l’espace de noms et l’en-tête de classe pour qu’ils correspondent à l’exemple suivant :
```
namespace DashboardSettingsPage
{
    public class MySettingTab : ISettingsData
    {
    }
}
```
Créez une instance du contrôle que vous avez défini pour l’onglet. Par exemple :
```
private MySettingsControl tab;
```
Ajoutez le constructeur de la classe. L’exemple de code suivant illustre le constructeur :
```
public MySettingTab()
{
   tab = new MySettingsControl();
}
```
Ajoutez la méthode Commit qui a pour effet de soumettre les modifications du paramètre. L’exemple de code suivant illustre la méthode Commit :
```
void ISettingsData.Commit(bool dismissed)
{
   // Implement the code that is required to submit your setting changes
}
```
Ajoutez la méthode TabControl, qui identifie le contrôle de l’onglet. L’exemple de code suivant illustre la méthode TabControl :
```
System.Windows.Forms.Control ISettingsData.TabControl
{
   get { return tab; }
}
```
Ajoutez la méthode TabId, qui fournit un identificateur unique pour l’onglet. L’exemple de code suivant illustre la méthode TabId :
```
private Guid id = Guid.NewGuid();

Guid ISettingsData.TabId
{
   get { return id; }
}
```
Ajoutez la méthode TabOrder, qui retourne l’ordre de l’onglet. L’exemple de code suivant illustre la méthode TabOrder :
```
int ISettingsData.TabOrder
{
   get { return 0; }
}
```
Notes

L'ordre des onglets est déterminé par l'utilisation de chiffres commençant par 0. Les onglets des paramètres Microsoft sont affichés en premier et sont suivis de vos propres onglets en fonction du classement que vous avez défini. Si vous disposez de trois onglets de paramètres, par exemple, attribuez-leur les valeurs 0, 1 et 2 en fonction de l’ordre d’affichage voulu.
Ajoutez la méthode TabTitle, qui fournit le titre de l’onglet. L’exemple de code suivant illustre la méthode TabTitle :
```
string ISettingsData.TabTitle
{
  get { return "My Settings Tab"; }
}
```
Notes

Le texte du titre peut également provenir d’un fichier de ressources lorsqu’il est nécessaire de localiser son contenu dans une autre langue.
Enregistrez et générez la solution.

Signature de l'assembly avec une signature Authenticode

Vous devez signer l'assembly avec une signature Authenticode pour pouvoir l'utiliser dans le système d'exploitation. Pour plus d’informations sur la signature de l’assembly, consultez Signature et vérification d’un code avec Authenticode.

Installation de l’assembly sur l’ordinateur de référence

Après avoir généré la solution, placez une copie du fichier DashboardSettingsPage.dll dans le dossier suivant sur l’ordinateur de référence :

%Programfiles%\Windows Server\Bin\OEM

Voir aussi

Création et personnalisation de l’image Personnalisations supplémentaires Préparation de l’image pour le déploiement Test de l’expérience client

Partager via