Adicionar uma guia a Configurações

Aplica-se a: Windows Server Essentials 2016, Windows Server R2 Essentials 2012, Windows Server Essentials 2012

Você pode adicionar uma guia a Configurações no Dashboard criando e instalando um assembly de código usado pelo Gerenciador de Parâmetros no sistema operacional.

Adicionar uma guia a Configurações

Você adiciona uma guia a Configurações executando as seguintes tarefas:

• Adicionar uma implementação da interface ISettingsData ao assembly.

• Assinar o assembly com uma assinatura Authenticode.

• Instalar o assembly no computador de referência.

Adicionar uma implementação da interface ISettingsData ao assembly

A interface ISettingsData está incluída no namespace Microsoft.WindowsServerSolutions.Settings do assembly do AdminCommon.dll localizado em \Arquivos de programa\Windows Server\Bin.

Para adicionar o código de ISettingsData ao assembly

1. Abra o Visual Studio 2010 como administrador clicando com o botão direito do mouse no programa no menu Iniciar e selecione Executar como administrador.

2. Clique em Arquivo, em Novo e em Projeto.

3. Na caixa de diálogo Novo Projeto, clique em Visual C#, clique em Biblioteca de Classes, digite DashboardSettingsPage para o nome da solução e clique em OK.

   Importante

   O assembly instalado no servidor deve ser chamado de DashboardSettingsPage.dll e então copiar o dll em %Arquivos de programas%\Windows Server\Bin\OEM.

4. Crie o controle que você deseja usar na guia. Neste exemplo, o controle de configurações se chama MySettingsControl.

5. Renomeie o arquivo Class1.cs. Por exemplo, MySettingTab.cs.

6. Adicionar uma referência ao arquivo AdminCommon.dll.

7. Adicione a seguinte instrução usando:

   using Microsoft.WindowsServerSolutions.Settings;
   

8. Altere o namespace e o cabeçalho de classe para corresponder ao exemplo a seguir:

   
   namespace DashboardSettingsPage
   {
       public class MySettingTab : ISettingsData
       {
       }
   }
   
   

9. Crie uma instância do controle que você criou para a guia. Por exemplo:

   private MySettingsControl tab;
   

10. Adicionar o construtor da classe. O exemplo de código a seguir mostra o construtor:

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

11. Adicione o método Commit, que envia as alterações de configuração. O exemplo de código a seguir mostra o método Commit:

    
    void ISettingsData.Commit(bool dismissed)
    {
       // Implement the code that is required to submit your setting changes
    }
    

12. Adicione o método TabControl, que identifica o controle para a guia. O seguinte exemplo de código mostra o método TabControl:

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

13. Adicione o método TabId, que fornece um identificador exclusivo para a guia. O seguinte exemplo de código mostra o método TabId:

    
    private Guid id = Guid.NewGuid();
    
    Guid ISettingsData.TabId
    {
       get { return id; }
    }
    

14. Adicione o método TabOrder, que retorna a ordem da guia. O seguinte exemplo de código mostra o método TabOrder:

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

    Observação

    A ordem da guia é definida usando números iniciando em 0. As guias de configuração internas da Microsoft são exibidas primeiro; a seguir, suas guias são exibidas, com base na ordem de guias definida por você. Por exemplo, se você tem três guias de configuração, especifique a ordem das guias como 0, 1 e 2 com base na ordem em que deseja que elas sejam exibidas.

15. Adicione o método TabTitle, que fornece o título da guia. O seguinte exemplo de código mostra o método TabTitle:

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

    Observação

    O texto do título também pode vir de um arquivo de recurso para acomodar necessidades de localização.

16. Salve e crie a solução.

Assinar o assembly com uma assinatura Authenticode

Você deve assinar com a Authenticode o assembly para que seja usado no sistema operacional. Para obter mais informações sobre a assinatura do assembly, consulte Assinando e verificando códigos com Authenticode.

Instalar o assembly no computador de referência

Depois de criar a solução com êxito, coloque uma cópia do arquivo DashboardSettingsPage.dll na seguinte pasta no computador de referência:

%Programfiles%\Windows Server\Bin\OEM

Consulte Também

Criar e personalizar a imagemPersonalizações adicionaisPreparar a imagem para a implantaçãoTestar a experiência do cliente