Compartir a través de


Cómo crear un cuadro de diálogo Configuration Manager

Estos procedimientos muestran cómo crear un ensamblado de cuadro de diálogo modeless, en Configuration Manager, mediante Visual Studio.

La creación del cuadro de diálogo es muy similar a la creación de una hoja de propiedades. Cree una clase derivada de SmsPageControl y un archivo XML para describir el cuadro de diálogo.

Para obtener más información sobre el administrador de propiedades, vea Uso de objetos pasados a un Configuration Manager Forms.

Después de compilar correctamente el ensamblado del cuadro de diálogo, debe hacer lo siguiente para integrarlo en la consola de Configuration Manager:

  1. Defina e implemente el formato XML que vincula la acción seleccionada al ensamblado que cree en este tema. Para obtener más información, vea How to Create Form XML for a Configuration Manager Dialog Box.

  2. Defina e implemente el XML de acción para mostrar el menú contextual que selecciona el usuario. Para obtener más información, vea How to Create Action XML for a Configuration Manager Dialog Box.

    Cuando haya creado el ensamblado de cuadro de diálogo y XML, haga clic con el botón derecho en un paquete en el nodo Paquetes del árbol de consola Configuration Manager y, a continuación, haga clic en Mostrar mi cuadro de diálogo. Aparece un cuadro de diálogo con un botón. Al hacer clic en el botón se muestra un cuadro de mensaje que contiene el nombre del paquete seleccionado.

Creación de la clase control

El procedimiento siguiente crea el control para el cuadro de diálogo.

Para crear el proyecto de Visual Studio

  1. En Visual Studio 2010, en el menú Archivo , seleccione Nuevoy, a continuación, haga clic en Proyecto para abrir el cuadro de diálogo Nuevo proyecto .

  2. En la lista de proyectos de Visual C#, Windows, seleccione la plantilla de proyecto Biblioteca de controles de Windows y escriba ConfigMgrDialogControl en el cuadro Nombre .

  3. Haga clic en Aceptar para crear el proyecto de Visual Studio.

  4. En Explorador de soluciones, haga clic con el botón derecho en UserControl1.cs, haga clic en Cambiar nombrey cambie el nombre a ConfigMgrDialogControl.cs.

  5. En el Explorador de soluciones, haga clic con el botón secundario en Referencias y, a continuación, haga clic en Agregar referencia.

  6. En el cuadro de diálogo Agregar referencia, haga clic en la pestaña Examinar, vaya a %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin y, a continuación, seleccione microsoft.configurationmanagement.exe, microsoft.configurationmanagement.managementprovider.dll, Microsoft.ConfigurationManagement.DialogFoundation.dll y AdminUI.DialogFoundation.dll. Haga clic en Aceptar para agregar los ensamblados como referencias de proyecto.

  7. En Explorador de soluciones, haga clic con el botón derecho en ConfigMgrDialogControl.cs y, a continuación, haga clic en Ver código.

  8. En el código fuente, cambie el espacio de nombres a Microsoft.ConfigurationManagement.AdminConsole.ConfigMgrDialogBox

  9. Cambie la clase ConfigMgrDialogControl para que se derive de SmsCustomDialog.

  10. En Explorador de soluciones, haga clic con el botón derecho en ConfigMgrDialogControl.Designer.cs y, a continuación, haga clic en Ver código.

  11. En el código fuente, cambie el espacio de nombres a Microsoft.ConfigurationManagement.AdminConsole.ConfigMgrDialogBox

  12. Cambie la clase ConfigMgrDialogControl para que se derive de SmsCustomDialog.

  13. En ConfigMgrDialogControl.cs, agregue el código siguiente para inicializar el control:

    public override bool Initialize(System.Reflection.Assembly assembly, SmsFormData formData, SmsPageData pageData)  
    {  
        base.Initialize(assembly, formData, pageData);  
        return true;  
    }   
    
  14. En Explorador de soluciones, haga clic con el botón derecho en ConfigMgrDialogControl.cs y seleccione Diseñador de vistas.

  15. En el cuadro de herramientas, haga clic en la pestaña Controles comunes y, a continuación, haga doble clic en Botón. Se agrega un botón denominado button1 al control en el Diseñador de controles de usuario.

  16. En el Diseñador de controles de usuario, haga doble clic en button1 y escriba el código siguiente en el código fuente del método button1_Click mostrado:

    MessageBox.Show( PageData.PropertyManager["Name"].StringValue);  
    

Implementación del ensamblado

El siguiente procedimiento compila y copia el ensamblado que ha creado en la carpeta de consola assemblies de Configuration Manager. Para obtener información importante sobre la implementación de extensiones de consola de Configuration Manager, consulte Acerca de Configuration Manager Implementación de extensiones de consola.

Para implementar el ensamblado del cuadro de diálogo

  1. Compile el proyecto y, en función de dónde haya creado el proyecto, la instalación de Visual Studio, el ensamblado se crea como \Visual Studio 2010\Projects\ConfigMgDialogControl\ConfigMgrDialogControl\bin\Debug\ConfigMgrDialogControl.dll.

  2. Copie el ensamblado en la carpeta %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin.

Consulta también

Cómo agregar una página de propiedades a una hoja de propiedades Configuration Manager existente
Cómo crear XML de acción para una hoja de propiedades de Configuration Manager
Creación de XML de formulario para una hoja de propiedades de Configuration Manager
Uso de objetos pasados a un formulario de Configuration Manager