Agregar una pestaña a Configuración

Artículo
08/29/2023

Se aplica a: Windows Server 2016 Essentials, Windows Server 2012 R2 Essentials, Windows Server 2012 Essentials

Puede agregar una ficha a Configuración en el Panel; para ello, cree e instale un ensamblado de código usado por el Administrador de configuración en el sistema operativo.

Agregar una ficha a Configuración

Complete las tareas siguientes para agregar una ficha a Configuración:

Agregue una implementación de la interfaz de ISettingsData al ensamblado

La interfaz de ISettingsData está incluida en el espacio de nombres de Microsoft.WindowsServerSolutions.Settings del ensamblado AdminCommon.dll que se encuentra en \Archivos de programa\Windows Server\Bin.

Para agregar el código ISettingsData al ensamblado

Abra Visual Studio 2010 como administrador; para ello, haga clic con el botón secundario en el menú Inicio y seleccione Ejecutar como administrador.
Haga clic en Archivo, Nuevo y a continuación haga clic en Proyecto.
En el cuadro de diálogo Nuevo proyecto, haga clic en Visual C#, Biblioteca de clases, escriba DashboardSettingsPage como el nombre de la solución y a continuación haga clic en Aceptar.

Importante

El conjunto que se instala en el servidor debe nombrarse DashboardSettingsPage.dll y, a continuación, copiar la dll a %ProgramFiles%\Windows Server\Bin\OEM.
Cree el control que desea usar en la pestaña. En este ejemplo, el control de configuración se denomina MySettingsControl.
Cambie el nombre del archivo Class1.cs. Por ejemplo, MySettingTab.cs.
Agregue una referencia al archivo AdminCommon.dll.

Agregue la siguiente instrucción using:

using Microsoft.WindowsServerSolutions.Settings;

Cambie el espacio de nombres y el encabezado de la clase para que coincida con el ejemplo siguiente:
```
namespace DashboardSettingsPage
{
    public class MySettingTab : ISettingsData
    {
    }
}
```
Cree una instancia del control que haya creado para la pestaña. Por ejemplo:
```
private MySettingsControl tab;
```
Agregue el constructor de la clase. En el siguiente ejemplo de código se muestra el constructor:
```
public MySettingTab()
{
   tab = new MySettingsControl();
}
```
Agregue el método Commit, que envía los cambios en la configuración. En el siguiente ejemplo de código se muestra el método Commit:
```
void ISettingsData.Commit(bool dismissed)
{
   // Implement the code that is required to submit your setting changes
}
```
Agregue el método TabControl, que identifica el control de la pestaña. En el ejemplo de código siguiente se muestra el método TabControl:
```
System.Windows.Forms.Control ISettingsData.TabControl
{
   get { return tab; }
}
```
Agregue el método TabId, que proporciona un identificador único para la pestaña. En el ejemplo de código siguiente se muestra el método TabId:
```
private Guid id = Guid.NewGuid();

Guid ISettingsData.TabId
{
   get { return id; }
}
```
Agregue el método TabOrder, que devuelve el orden de la pestaña. En el ejemplo de código siguiente se muestra el método TabOrder:
```
int ISettingsData.TabOrder
{
   get { return 0; }
}
```
Nota

El orden de las fichas se define utilizando números a partir de 0. Las pestañas integradas de configuración de Microsoft se muestran primero y a continuación las pestañas del usuario en función del orden establecido. Por ejemplo, si dispone de tres pestañas de configuración, puede especificar el orden como 0, 1 y 2, dependiendo del orden en que desee que aparezcan.
Agregue el método TabTitle, que proporciona el título de la pestaña. En el ejemplo de código siguiente se muestra el método TabTitle:
```
string ISettingsData.TabTitle
{
  get { return "My Settings Tab"; }
}
```
Nota

El texto del título también puede proceder de un archivo de recursos que se adapte a sus necesidades de localización.
Guarde y genere la solución.

Firme el ensamblado con una firma Authenticode

Para poder utilizar el ensamblado en el sistema operativo es necesario firmarlo mediante Authenticode. Para obtener más información acerca de cómo firmar el ensamblado, consulte Signing and Checking Code with Authenticode (Firma y comprobación de código con Authenticode).

Instale el ensamblado en el equipo de referencia

Después de crear correctamente la solución, coloque una copia del archivo DashboardSettingsPage.dll en la siguiente carpeta del equipo de referencia:

%Programfiles%\Windows Server\Bin\OEM

Vea también

Creación y personalización de la imagen Personalizaciones adicionales Preparación de la imagen para su implementación Prueba de la experiencia del cliente

Compartir a través de