Como criar um controlador de configuração controlo de ação personalizado

No Gestor de Configuração, para criar um controlo de ação personalizado, cria-se um controlo Windows utilizando as duas classes seguintes:

Estes procedimentos mostram-lhe como criar um conjunto de controlo de implementação do sistema operativo Do Gestor de Configuração utilizando Visual Studio 2005. Quando é carregado no Editor de Sequência de Tarefas, o controlo apresenta uma página de propriedade que contém uma caixa de texto que é usada para definir uma variável de ação do nome de utilizador para a ação personalizada.

Depois de ter concluído estes passos, execute os passos nos seguintes tópicos para criar o ficheiro de formato de objeto gerido por ação personalizada (MOF) e utilizar o controlo de ação personalizado.

Como criar um ficheiro MOF para uma ação personalizada do gestor de configuração

Como usar uma ação personalizada do gestor de configuração

O Visual Studio Project de Controlo

O procedimento a seguir cria o projeto de controlo de ação personalizado.

Criar o controlo

1. Em Visual Studio 2010, no menu Ficheiro, aponte para New, e clique em Project para abrir a caixa de diálogo Nova Project.

2. Da lista de projetos visual C# , Windows, selecione o modelo de projeto da Biblioteca de Controlo de Windows e, em seguida, escreva na caixa ConfigMgrTSAction Nome.

3. Clique em OK para criar o projeto Visual Studio.

4. No Solution Explorer, clique à direita no UserControl1.cs, clique em Mudar de nome e, em seguida, altere o nome para ConfigMgrTSActionControl.cs .

5. No Solution Explorer, clique à direita Referências e, em seguida, clique em Adicionar Referência.

6. Na caixa de diálogo de referência adicionar, clique no separador Procurar, navegue para %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin e, em seguida, selecione os seguintes conjuntos:

   • Adminui.osdcommon.dll

   • Adminui.tasksequenceeditor.dll

   • Adminui.wqlqueryengine.dll

   • Microsoft.configurationmanagement.exe

   • Microsoft.configurationmanagement.managementprovider.dll

7. Clique em OK para adicionar os conjuntos como referências do projeto.

8. No Solution Explorer, clique à direita ConfigMgrTSActionControl.cs, e, em seguida, clique em Ver Código.

9. Adicione o seguinte código para incluir os espaços de nome necessários:

   using Microsoft.ConfigurationManagement.AdminConsole;  
   using Microsoft.ConfigurationManagement.AdminConsole.TaskSequenceEditor;  
   

10. Altere a classe ConfigMgrTSActionControl para que deriva do SmsOsdEditorPageControl.

11. No ConfigMgrTSActionControl.cs, adicione o seguinte novo construtor à classe ConfigMgrTSActionControl:

    public ConfigMgrTSActionControl(SmsPageData data) : base(data)   
    {   
        InitializeComponent();   
    }  
    

12. Adicione o seguinte método para inicializar o controlo:

    public override void InitializePageControl()  
    {  
       base.InitializePageControl();  
    }  
    

Criar um controlo de opções

O procedimento a seguir cria o código que declara o controlo de opções para a ação personalizada. Esta implementação utiliza o controlo de opções predefinidos.

Para criar um controlo de opções

• No final do ConfigMgrTSActionControl.cs adicione a seguinte nova classe no espaço de nomes ConfigMgrTSAction:

  public class ConfigureTSActionOptions : TaskSequenceOptionControl  
  {  
      public ConfigureTSActionOptions() : base()   
      {  
      }  
      public ConfigureTSActionOptions(SmsPageData data) : base(data)   
      {  
      }  
  }  
  
  

Personalize a Interface do Utilizador

O procedimento seguinte adiciona uma caixa de texto e código para gerir dados de ação.

Para adicionar a interface de utilizador

1. No Solution Explorer, clique à direita ConfigMgrTSActionControl.cs, e, em seguida, clique em Ver Design.

2. Na caixa de ferramentas, clique no separador Controlos Comuns e, em seguida, clique duas vezes em TextBox. Um botão nomeado textBox1 é adicionado ao seu controlo no User Control Designer.

3. Clique duas vezes na caixa de texto. Um manipulador de eventos nomeado textBox1_TextChanged é adicionado à classe ConfigMgrTSActionControl. Adicione o seguinte código para garantir que as alterações são guardadas ao gestor de propriedade da ação:

   SetDirtyFlag(true);  
   

4. Na classe ConfigMgrTSActionControl, adicione o seguinte método para escrever o valor da caixa de texto à User propriedade definida na ação personalizada MOF. Isto é chamado quando o botão OK ou Apply é clicado.

   protected override bool ApplyChanges(out Control errorControl, out bool showError)  
   {  
       // You can check the error here and return false.  
       if (this.HasError(out errorControl) == true)  
       {  
           this.ShowMessageBox(  
               this.GetErrorString(),  
               "Error",  
               MessageBoxButtons.OK,  
               MessageBoxIcon.Warning);  
           errorControl = null;  
           showError = true;  
           return false;  
       }  
       this.PropertyManager["User"].StringValue = textBox1.Text;  
   
       return base.ApplyChanges(out errorControl, out showError);  
   }  
   

5. Na vista de design para o controlo, clique duas vezes no controlo para criar o método ConfigMgrTSActionControl_Load.

6. Adicione o seguinte código ao método. Este código carrega a caixa de texto com um valor de Utilizador existente. Isto acontece quando a ação da sequência de tarefas é editada após a sua criação.

   textBox1.Text = this.PropertyManager["User"].StringValue;  
   

Cordas de Recursos

O procedimento a seguir adiciona as cadeias de recursos que são utilizadas para exibir o nome de ação personalizado no Editor de Sequência de Tarefas.

Para adicionar cordas de recursos

1. No Solution Explorer, no menu Project, clique em Propriedades.

2. Clique no separador Recursos. Se o ficheiro de recursos não existir, crie-o selecionando a mensagem que é exibida no separador Recursos.

3. Na barra de ferramentas Resource Designer, aponte para a visão de recurso para baixo, clique na seta e certifique-se de que está definida para Cordas (que é o padrão). Aparece uma grelha de definições, exibindo as cordas que são mantidas por esse exemplo do Designer de Recursos.

4. Clique na coluna Nome da última linha da grelha, que está marcada com um asterisco (*).

5. Na coluna Nome, insira DefaultDisplay_ConfigMgrTSAction como o nome da corda.

6. Na coluna Valor, introduza a ação personalizada da cadeia . Esta é a cadeia exibida na lista de ações de sequência de tarefas.

7. Clique na coluna Nome da última linha da grelha, que está marcada com um asterisco (*).

8. Na coluna Nome, insira ConfigMgrTSAction como o nome da corda.

9. Na coluna Valor, insira Custom Action . Esta é a cadeia que é exibida quando adiciona a ação personalizada.

Implantar a Assembleia

Este procedimento constrói e copia a montagem que criou para a pasta de conjuntos de consolas Do Gestor de Configuração. Para obter informações importantes sobre a implementação de extensões de consola do Gestor de Configuração, consulte sobre a implementação da extensão da extensão do administrador de configuraçãodo administrador .

Para implantar a montagem

1. Crie o projeto. Visual Studio cria o conjunto como \Visual Studio 2005\Projects\ConfigMgrControl\ConfigMgrTSAction\bin\Debug\ConfigMgrTSActionControl.dll.

2. Copie o conjunto para a pasta %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin.

Consulte também

Sobre a extensão da consola do gestor de configuração
Implementação da extensão da extensão da consola do gestor de configuração
Como criar um ficheiro MOF para uma ação personalizada do gestor de configuração
Como usar uma ação personalizada do gestor de configuração