Aggiungere una scheda a Impostazioni

  • Articolo

Si applica a: 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.

Aggiunta di una scheda a Impostazioni

È possibile aggiungere una scheda a Impostazioni facendo quanto segue:

Aggiunta di un'implementazione dell'interfaccia ISettingsData all'assembly

L'interfaccia ISettingsData è inclusa nello spazio dei nomi Microsoft.WindowsServerSolutions.Settings dell'assembly AdminCommon.dll, situato in \Program Files\Windows Server\Bin.

Per aggiungere il codice ISettingsData all'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.

  2. Fare clic su File, quindi su Nuovoe infine su Progetto.

  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.

    Importante

    L'assembly installato sul server deve chiamarsi DashboardSettingsPage.dll e deve essere copiato in %ProgramFiles%\Windows Server\Bin\OEM.

  4. Creare il controllo che si desidera utilizzare nella scheda . In questo esempio il controllo delle impostazioni è denominato My Impostazioni Control.

  5. Rinominare il file Class1.cs. Ad esempio, MySettingTab.cs.

  6. Aggiungere un riferimento al file AdminCommon.dll.

  7. Aggiungere l'istruzione using seguente:

    using Microsoft.WindowsServerSolutions.Settings;

  8. Modificare lo spazio dei nomi e l'intestazione della classe in modo tale che corrispondano all'esempio seguente:

    
namespace DashboardSettingsPage
{
    public class MySettingTab : ISettingsData
    {
    }
}

  9. Creare un'istanza del controllo creato per la scheda. Per esempio:

    private MySettingsControl tab;

  10. Aggiungere il costruttore per la classe. Nell'esempio di codice riportato di seguito viene illustrato il costruttore:

    
public MySettingTab()
{
   tab = new MySettingsControl();
}

  11. Aggiungere il metodo Commit, che invia le modifiche apportate alle impostazioni. Nell'esempio di codice riportato di seguito viene illustrato il metodo Commit:

    
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. L'esempio di codice seguente illustra il metodo TabControl:

    
System.Windows.Forms.Control ISettingsData.TabControl
{
   get { return tab; }
}

  13. Aggiungere il metodo TabId, che fornisce un identificatore univoco per la scheda. L'esempio di codice seguente illustra il metodo TabId:

    
private Guid id = Guid.NewGuid();

Guid ISettingsData.TabId
{
   get { return id; }
}

  14. Aggiungere il metodo TabOrder, che restituisce l'ordine della scheda. L'esempio di codice seguente illustra il metodo TabOrder:

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

    Nota

    L'ordine delle schede viene definito utilizzando i numeri a partire da 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. 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.

  15. Aggiungere il metodo TabTitle, che fornisce il titolo della scheda. L'esempio di codice seguente illustra il metodo TabTitle:

    
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.

  16. Salvare e compilare la soluzione.

Applicazione di una firma Authenticode all'assembly

Per poter utilizzare l'assembly nel sistema operativo, è necessario applicarvi una firma Authenticode. Per altre informazioni sulla firma dell'assembly, vedere Firma e verifica del codice con Authenticode.

Installazione dell'assembly nel computer di riferimento

Una volta generata la soluzione, copiare il file DashboardSettingsPage.dll nella seguente cartella sul computer di riferimento:

%Programfiles%\Windows Server\Bin\OEM

Vedi anche

Creazione e personalizzazione dell'immaginePersonalizzazioni aggiuntivePreparazione dell'immagine per la distribuzioneTest dell'esperienza del cliente