Como criar uma caixa de diálogo Configuration Manager

Artigo
04/04/2023

Esses procedimentos mostram como criar um assembly de caixa de diálogo modeless, em Configuration Manager, usando o Visual Studio.

A criação da caixa de diálogo é muito semelhante à criação de uma folha de propriedades. Você cria uma classe derivada de SmsPageControl e um arquivo XML para descrever a caixa de diálogo.

Para obter mais informações sobre o gerenciador de propriedades, consulte Como usar objetos passados para um Configuration Manager Forms.

Depois de criar com êxito o assembly da caixa de diálogo, você deve fazer o seguinte para integrá-lo ao console Configuration Manager:

Defina e implante o formulário XML que vincula a ação selecionada ao assembly que você cria neste tópico. Para obter mais informações, consulte Como criar o Formulário XML para uma caixa de diálogo Configuration Manager.
Defina e implante o XML de ação para exibir o menu de contexto selecionado pelo usuário. Para obter mais informações, consulte Como criar Ação XML para uma caixa de diálogo Configuration Manager.

Quando você tiver criado o assembly de diálogo e XML, clique com o botão direito do mouse em um pacote no nó pacotes da árvore de console Configuration Manager e clique em Mostrar minha Caixa de Diálogo. Uma caixa de diálogo é exibida com um botão nela. Clicar no botão exibe uma caixa de mensagens que contém o nome do pacote selecionado.

Criar a Classe de Controle

O procedimento a seguir cria o controle para a caixa de diálogo.

Para criar um projeto do Visual Studio

No Visual Studio 2010, no menu Arquivo , aponte para Novo e clique em Projeto para abrir a caixa de diálogo Novo Projeto .
Na lista do Visual C#, projetos do Windows, selecione o modelo de projeto da Biblioteca de Controle do Windows e digite ConfigMgrDialogControl na caixa Nome .
Clique em OK para criar o projeto do Visual Studio.
Em Gerenciador de Soluções, clique com o botão direito do mouse em UserControl1.cs, clique em Renomear e altere o nome para ConfigMgrDialogControl.cs.
Em Gerenciador de Soluções, clique com o botão direito do mouse em Referências e clique em Adicionar Referência.
Na caixa de diálogo Adicionar Referência, clique na guia Procurar, navegue até %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin e selecione microsoft.configurationmanagement.exe, microsoft.configurationmanagement.managementprovider.dll, Microsoft.ConfigurationManagement.DialogFoundation.dll e AdminUI.DialogFoundation.dll. Clique em OK para adicionar os assemblies como referências de projeto.
Em Gerenciador de Soluções, clique com o botão direito do mouse em ConfigMgrDialogControl.cs e clique em Exibir Código.
No código-fonte, altere o namespace para Microsoft.ConfigurationManagement.AdminConsole.ConfigMgrDialogBox
Altere a classe ConfigMgrDialogControl para que ela deriva de SmsCustomDialog.
Em Gerenciador de Soluções, clique com o botão direito do mouse em ConfigMgrDialogControl.Designer.cs e clique em Exibir Código.
No código-fonte, altere o namespace para Microsoft.ConfigurationManagement.AdminConsole.ConfigMgrDialogBox
Altere a classe ConfigMgrDialogControl para que ela deriva de SmsCustomDialog.

Em ConfigMgrDialogControl.cs, adicione o seguinte código para inicializar o controle:

public override bool Initialize(System.Reflection.Assembly assembly, SmsFormData formData, SmsPageData pageData)  
{  
    base.Initialize(assembly, formData, pageData);  
    return true;  
}

Em Gerenciador de Soluções, clique com o botão direito do mouse em ConfigMgrDialogControl.cs e selecione Exibir Designer.
Na caixa de ferramentas, clique na guia Controles Comuns e clique duas vezes em Botão. Um botão chamado button1 é adicionado ao seu controle no Designer de Controle de Usuário.
No Designer de Controle de Usuário, clique duas vezes no botão1 e digite o seguinte código no código-fonte do método button1_Click exibido:
```
MessageBox.Show( PageData.PropertyManager["Name"].StringValue);  
```

Implantar o Assembly

O procedimento a seguir compila e copia o assembly que você criou para a pasta Configuration Manager consoleassemblies. Para obter informações importantes sobre como implantar extensões de console Configuration Manager, consulte Sobre Configuration Manager Implantação de Extensão de Console.

Para implantar o assembly da caixa de diálogo

Crie o projeto e, dependendo de onde você criou seu projeto, sua instalação do Visual Studio, o assembly é criado como \Visual Studio 2010\Projects\ConfigMgDialogControl\ConfigMgrDialogControl\bin\Debug\ConfigMgrDialogControl.dll.
Copie o assembly para a pasta %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin.

Confira também

Como adicionar uma página de propriedade a uma folha de propriedades Configuration Manager existente
Como criar o XML de ação para uma folha de propriedades Configuration Manager
Como criar xml de formulário para uma folha de propriedades Configuration Manager
Como usar objetos passados para um formulário de Configuration Manager