Aggiungere una scheda a ImpostazioniAdd a Tab to Settings

Si applica a: Windows Server 2016 Essentials, Windows Server 2012 R2 Essentials, Windows Server 2012 EssentialsApplies To: Windows Server 2016 Essentials, Windows Server 2012 R2 Essentials, Windows Server 2012 Essentials

È possibile aggiungere una scheda a Impostazioni nel dashboard creando e installando un assembly del codice utilizzato da Gestione impostazioni nel sistema operativo.You can add a tab to Settings on the Dashboard by creating and installing a code assembly that is used by the Settings Manager in operating system.

Aggiunta di una scheda a ImpostazioniAdd a tab to Settings

È possibile aggiungere una scheda a Impostazioni facendo quanto segue:You add a tab to Settings by performing the following tasks:

Aggiungere un'implementazione dell'interfaccia ISettingsData all'assemblyAdd an implementation of the ISettingsData interface to the assembly

L'interfaccia ISettingsData è inclusa nello spazio dei nomi Microsoft.WindowsServerSolutions.Settings dell'assembly AdminCommon.dll, situato in \Program Files\Windows Server\Bin.The ISettingsData interface is included in the Microsoft.WindowsServerSolutions.Settings namespace of the AdminCommon.dll assembly which is located in \Program Files\Windows Server\Bin.

Per aggiungere il codice ISettingsData all'assemblyTo add the ISettingsData code to the assembly
  1. Accedere a Visual Studio 2010 come amministratore facendo clic con il pulsante destro del mouse sul programma nel menu Start, quindi selezionando Esegui come amministratore.Open Visual Studio 2010 as an administrator by right-clicking the program in the Start menu and selecting Run as administrator.

  2. Fare clic su File, quindi su Nuovoe infine su Progetto.Click File, click New, and then click Project.

  3. Nella finestra di dialogo Nuovo progetto fare clic su Visual C# e poi su Libreria di classi, immettere DashboardSettingsPage come nome della soluzione e quindi fare clic su OK.In the New Project dialog box, click Visual C#, click Class Library, enter DashboardSettingsPage for the name for the solution, and then click OK.

    Importante

    L'assembly installato sul server deve chiamarsi DashboardSettingsPage.dll e deve essere copiato in %ProgramFiles%\Windows Server\Bin\OEM.The assembly that is installed on the server must be named DashboardSettingsPage.dll and then copy the dll to %ProgramFiles%\Windows Server\Bin\OEM.

  4. Creare il controllo che si desidera utilizzare nella scheda. In questo esempio il controllo delle impostazioni è denominato MySettingsControl.Create the control that you want to be used in the tab. In this example the settings control is named MySettingsControl.

  5. Rinominare il file Class1.cs.Rename the Class1.cs file. Ad esempio, MySettingTab.cs.For example, MySettingTab.cs.

  6. Aggiungere un riferimento al file AdminCommon.dll.Add a reference to the AdminCommon.dll file.

  7. Aggiungere la seguente istruzione using:Add the following using statement:

    using Microsoft.WindowsServerSolutions.Settings;  
    
  8. Modificare lo spazio dei nomi e l'intestazione della classe in modo tale che corrispondano all'esempio seguente:Change the namespace and the class header to match the following example:

    
    namespace DashboardSettingsPage  
    {  
        public class MySettingTab : ISettingsData  
        {  
        }  
    }  
    
    
  9. Creare un'istanza del controllo creato per la scheda. Ad esempio: Instantiate an instance of the control that you created for the tab. For example:

    private MySettingsControl tab;  
    
  10. Aggiungere il costruttore per la classe.Add the constructor for the class. Nell'esempio di codice riportato di seguito viene illustrato il costruttore:The following code example shows the constructor:

    
    public MySettingTab()  
    {  
       tab = new MySettingsControl();  
    }  
    
  11. Aggiungere il metodo Commit, che invia le modifiche apportate alle impostazioni.Add the Commit method, which submits the setting changes. Nell'esempio di codice riportato di seguito viene illustrato il metodo Commit:The following code example shows the Commit method:

    
    void ISettingsData.Commit(bool dismissed)  
    {  
       // Implement the code that is required to submit your setting changes  
    }  
    
  12. Aggiungere il metodo TabControl, che identifica il controllo per la scheda. Nell'esempio di codice riportato di seguito viene illustrato il metodo TabControl:Add the TabControl method, which identifies the control for the tab. The following code example shows the TabControl method:

    
    System.Windows.Forms.Control ISettingsData.TabControl  
    {  
       get { return tab; }  
    }  
    
  13. Aggiungere il metodo TabId, che fornisce un identificatore univoco per la scheda. Nell'esempio di codice riportato di seguito viene illustrato il metodo TabId:Add the TabId method, which provides a unique identifier for the tab. The following code example shows the TabId method:

    
    private Guid id = Guid.NewGuid();  
    
    Guid ISettingsData.TabId  
    {  
       get { return id; }  
    }  
    
  14. Aggiungere il metodo TabOrder, che restituisce l'ordine della scheda. Nell'esempio di codice riportato di seguito viene illustrato il metodo TabOrder:Add the TabOrder method, which returns the order of the tab. The following code example shows the TabOrder method:

    
    int ISettingsData.TabOrder  
    {  
       get { return 0; }  
    }  
    

    Nota

    L'ordine delle schede viene definito utilizzando i numeri a partire da 0.The tab order is defined by using numbers starting at 0. Le schede delle impostazioni predefinite Microsoft vengono visualizzate per prime, seguite poi dalle schede dell'utente visualizzate in base all'ordine da questo definito.The Microsoft built-in settings tabs are displayed first and then your tabs are displayed based on the tab order that you define. Ad esempio, se esistono tre schede di impostazioni, l'utente specifica il numero d'ordine delle schede come 0, 1 e 2 in base all'ordine di visualizzazione desiderato.For example, if you have three settings tabs, you specify the tab order as 0, 1, and 2 based on the order that you want the tabs to be displayed.

  15. Aggiungere il metodo TabTitle, che fornisce il titolo della scheda. Nell'esempio di codice riportato di seguito viene illustrato il metodo TabTitle:Add the TabTitle method, which provides the title of the tab. The following code example shows the TabTitle method:

    
    string ISettingsData.TabTitle  
    {  
      get { return "My Settings Tab"; }  
    }  
    

    Nota

    Il testo del titolo può inoltre provenire da un file di risorse per rispondere alle esigenze di localizzazione.The title text can also come from a resource file to accommodate localization needs.

  16. Salvare e generare la soluzione.Save and build the solution.

Firmare l'assembly con una firma AuthenticodeSign the assembly with an Authenticode signature

Per poter utilizzare l'assembly nel sistema operativo, è necessario applicarvi una firma Authenticode.You must Authenticode sign the assembly for it to be used in the operating system. Per altre informazioni sulla firma dell'assembly, vedere Firma e verifica del codice con Authenticode.For more information about signing the assembly, see Signing and Checking Code with Authenticode.

Installare l'assembly nel computer di riferimentoInstall the assembly on the reference computer

Una volta generata la soluzione, copiare il file DashboardSettingsPage.dll nella seguente cartella sul computer di riferimento:After you successfully build the solution, place a copy of the DashboardSettingsPage.dll file in the following folder on the reference computer:

%ProgramFiles%\Windows server\bin\oem.%Programfiles%\Windows Server\Bin\OEM

Vedere ancheSee Also

Creazione e personalizzazione dell'immagine Creating and Customizing the Image
Personalizzazioni aggiuntive Additional Customizations
Preparazione dell'immagine per la distribuzione Preparing the Image for Deployment
Testare l'esperienza dei clientiTesting the Customer Experience