ApplicationSettingsBase.Item[String] Propiedad

Definición

Obtiene o establece el valor de la propiedad de configuración de la aplicación especificada.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ propertyName); void set(System::String ^ propertyName, System::Object ^ value); };
public override object this[string propertyName] { get; set; }
member this.Item(string) : obj with get, set
Default Public Overrides Property Item(propertyName As String) As Object

Parámetros

propertyName
String

que String contiene el nombre de la propiedad a la que se va a tener acceso.

Valor de propiedad

Si se encuentra, el valor de la propiedad de configuración con nombre; de lo contrario, null.

Excepciones

No se encontraron propiedades asociadas al contenedor actual ni a la propiedad especificada.

Se intentó establecer una propiedad de solo lectura.

El valor proporcionado es de un tipo incompatible con la propiedad settings, durante una operación set.

No se pudo analizar el archivo de configuración.

Comentarios

La Item[] propiedad , también conocida como indexador, se usa de forma rutinaria en la clase contenedora de configuración derivada de ApplicationSettingsBase. Item[] enlaza la propiedad pública de la clase contenedora a la propiedad de configuración correspondiente.

Item[] genera varios eventos en función de la operación que se realiza:

  • La primera vez que se recupera una propiedad, se genera el SettingsLoaded evento .

  • Cuando se establece una propiedad, se genera el OnSettingChanging evento . Si el controlador no cancela el evento, se establece el valor de la propiedad y se genera el PropertyChanged evento.

Se aplica a

Consulte también