ApplicationSettingsBase.Item[String] Propiedad

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

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

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

Valor de propiedad

Object

Valor de la propiedad de configuración con nombre, si se encuentra uno; de lo contrario, null.

Excepciones

SettingsPropertyNotFoundException

No hay ninguna propiedad asociada al contenedor actual o no se ha podido encontrar la propiedad especificada.

SettingsPropertyIsReadOnlyException

Se ha intentado establecer una propiedad de sólo lectura.

SettingsPropertyWrongTypeException

El tipo de valor proporcionado no es compatible con la propiedad de configuración, durante una operación de conjunto.

ConfigurationErrorsException

No se pudo analizar el archivo de configuración.

Comentarios

La Item[] propiedad , también conocida como indexador, se usa habitualmente 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.

Consulte también

• Properties
• IsReadOnly