UiPath Documentation
sdk
latest
false
Importante :
Este contenido se ha localizado parcialmente a partir de un sistema de traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.
UiPath logo, featuring letters U and I in white

Guía del desarrollador

Última actualización 30 de mar. de 2026

UiPath.Studio.Activities.Api.Settings

En esta sección puedes encontrar más información sobre cómo crear actividades utilizando UiPath.Studio.Activities.Api.Settings.

IActivitiesSettingsService

Punto de entrada para funciones relacionadas con la configuración.

Herencia

IActivitiesSettingsReader > IActivitiesSettingsService

Métodos

void AddCategory(SettingsCategory category)

Añade una categoría de configuración en la interfaz de usuario de configuración del proyecto.

Tipo de parámetroNombre del parámetroDescripción
SettingsCategoryCategoríaLa descripción de la página de configuración.
void AddSection(SettingsCategory category, SettingsSection section)

Añade una sección a esta categoría.

Tipo de parámetroNombre del parámetroDescripción
SettingsCategoryCategoría
SettingsSectionSecciónSi la clave de sección no comienza con la clave de categoría, esta última se añade como prefijo de la primera y se actualiza el valor de SettingsElement.Key .
void AddSetting(SettingsEditorControlContainer parent, SettingDescriptionBase setting)

Genera un editor de configuración predeterminado basado en la configuración y lo pasa a AddSetting (SettingsEditorContainer).

Tipo de parámetroNombre del parámetroDescripción
SettingsEditorControlContainerPrincipalLa CategoríaDeConfiguración o la SecciónDeConfiguración donde se anexa el control de configuración generado.
SettingDescriptionBaseConfiguraciónLa descripción del ajuste que se utiliza para generar un control.
void AddSetting(SettingsEditorControlContainer parent, SettingsEditorControl setting)

Añadir un control de configuración

Tipo de parámetroNombre del parámetroDescripción
SettingsEditorControlContainerPrincipalLa CategoríaDeConfiguración o la SecciónDeConfiguración donde se anexa el control de configuración generado.
SettingsEditorControlConfiguraciónLa descripción del ajuste que se utiliza para generar un control.
bool TrySetValue (string key, string value)

Establece y guarda un valor de configuración.

Tipo de parámetroNombre del parámetroDescripción
StringclaveLa clave del entorno.
StringvalorEl valor de la configuración.

ModernClassicSettings

Nota:

Esta característica se introdujo en UiPath.Studio.Activities.Api v21.10.

Define cómo un paquete de actividades prefiere manejar las actividades Modernas frente a las Clásicas. Si se establece en UseGlobalSetting, diferirá el comportamiento a la configuración global de Studio. Si se establece explícitamente en UseModern o UseClassic , la configuración se sobrescribirá para el paquete en particular.

Constantes

TipoNombreDescripción
StringUseGlobalSettingDifiere la decisión a la configuración global de Studio.
StringUseModernHace que las actividades modernas sean las predeterminadas.
StringUseClassicHace que las actividades clásicas sean las predeterminadas.

MultipleValuesSelectorDescription

Un ajuste que permite seleccionar múltiples valores de una colección predefinida de valores.

Herencia

SettingsElement > SettingDescriptionBase > MultipleValuesSelectorDescription

Propiedades

TipoNombreDescripción
StringValoresValores posibles para seleccionar.
StringValores predeterminadosSelección predeterminada.

SettingDescriptionBase

Aplicar formato a un valor para mostrar.

Herencia

SettingsElement > SettingDescriptionBase

Propiedades

TipoNombreDescripción
StringDescripciónUna explicación del entorno.
BooleanoEsDeSoloLecturaSi se establece en true, el valor no se puede editar ni conservar.
BooleanoIsDesignTimeDevuelve truesi se invoca en el tiempo de diseño. Requiere Studio 2021.10 o posterior.
StringEtiquetaLa etiqueta que se utilizará para esta configuración.
BooleanoRequiresPackageReloadSi se establece en true, es necesario volver a cargar el paquete para cambiar esta configuración. Requiere Studio 2021.10 o posterior.

SettingDescriptionBase

Una descripción de configuración que se aplica a un tipo concreto.

Herencia

SettingsElement > SettingDescriptionBase > SettingDescriptionBase

Tipo genérico

El tipo de ajuste al que se aplica esta descripción.

Propiedades

TipoNombreDescripción
Func<T, string>GetDisplayValueFunción que debe devolver un valor de visualización con formato para un tipo determinado.

SettingsControlBase

Un elemento de configuración que forma parte de la interfaz de usuario.

Herencia

SettingsElement > SettingsControlBase

Propiedades

TipoNombreDescripción
BooleanoIsDesignTimeDevuelve true cuando se invoca en el tiempo de diseño. Requiere Studio 2021.10 o posterior.
BooleanoRequiresPackageReloadSi se establece en true, cambiar esta configuración requiere volver a cargar el paquete. Esto solo se aplica a la configuración de tiempo de diseño. Requiere Studio 2021.10 o posterior.

SettingsEditorControlBase

Editor de ajustes. Aparece como una etiqueta con un control asociado. Se puede pasar una instancia de esto a SettingsSection.AddSetting (SettingsEditorControl).

Herencia

SettingsElement > SettingsControlBase > SettingsEditorControlBase

Propiedades

TipoNombreDescripción
ControlDescriptionBaseControlEl control que se utilizará para esta configuración.
StringDescripción(Opcional) Un texto explicativo más largo para esta configuración, que se muestra como información sobre herramientas.
StringEtiqueta(Opcional) La etiqueta del editor de configuración. Puede ser un texto de Markdown.

SettingsEditorControlContainer

Un elemento de la interfaz de usuario de configuración que puede alojar editores.

Herencia

SettingsElement > SettingsControlBase > SettingsEditorControlContainer

SettingsElement

Clase base para elementos de configuración con claves asociadas.

Propiedades

TipoNombreDescripción
StringClaveLa clave única asociada con esta configuración. Utilizado para almacenamiento / recuperación.

SettingsCategory

Una categoría de configuración.

Herencia
Propiedades
TipoNombreDescripción
StringDescripción(Opcional) Mostrado debajo del título, explica el propósito de esta página.
StringEncabezadoEl encabezado de la categoría.
BooleanoIsHiddenSi se establece en true, la categoría no se mostrará en el cuadro de diálogo Configuración del proyecto. Requiere Studio 2020.4 o posterior.
Observaciones

Añade una categoría en la configuración del proyecto de actividades.

docs image

SettingsSection

Un cuadro de grupo de configuración que contiene los controles relacionados.

Herencia

Propiedades

TipoNombreDescripción
StringDescripción(Opcional) Debajo del título, se muestra una explicación del propósito de esta sección.
BooleanoIsExpandedSi se establece en true, la sección se expande de forma predeterminada.
StringTítuloEl título de la sección.

Observaciones

Añade un cuadro de grupo de configuración a la configuración del proyecto de actividades.

docs image

SingleValueEditorDescription

Una entrada de configuración que permite editar un único valor de tipo T. Se crea un editor predeterminado basado en T.

Herencia

Tipo genérico

El tipo de ajuste al que se aplica esta descripción.

Propiedades

TipoNombreDescripción
TValorPredeterminadoEl valor predeterminado de esta configuración.
Func<T, string>ValidarValidar un valor (se aplica a los editores que permiten la entrada de texto Free ).

SingleValueSelectorDescription

Un ajuste que permite seleccionar un único valor de una colección predefinida de valores.

Herencia

Propiedades

TipoNombreDescripción
string[]ValorValores posibles para seleccionar.

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado