ApplicationSettingsBase.Item[String] 属性

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

获取或设置指定的应用程序设置属性的值。

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

参数

propertyName

String

包含要访问的属性名称的 String。

属性值

Object

如果找到的话，则为命名的设置属性的值；否则为 null。

例外

SettingsPropertyNotFoundException

没有与当前包装关联的属性，或者未能找到指定的属性。

SettingsPropertyIsReadOnlyException

已尝试设置只读属性。

SettingsPropertyWrongTypeException

在设置操作期间，所提供值的类型与设置属性不兼容。

ConfigurationErrorsException

未能分析配置文件。

注解

属性 Item[] （也称为索引器）在派生自 ApplicationSettingsBase的设置包装类中经常使用。 Item[] 将包装类的公共属性绑定到相应的设置属性。

Item[] 根据正在执行的操作引发多个事件：

• 首次检索属性时， SettingsLoaded 将引发 事件。

• 设置属性时，将 OnSettingChanging 引发 事件。 如果处理程序不取消事件，则设置 属性值并 PropertyChanged 引发 事件。

另请参阅

• Properties
• IsReadOnly