SettingsBase.Item[String] 属性

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

Source:

SettingsBase.cs

获取或设置指定设置属性的值。

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ propertyName); void set(System::String ^ propertyName, System::Object ^ value); };

public virtual object this[string propertyName] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overridable Property Item(propertyName As String) As Object

参数

propertyName

String

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

属性值

Object

如果找到，则为该命名的设置属性的值。

例外

SettingsPropertyNotFoundException

没有与当前对象关联的属性，或找不到指定属性。

SettingsPropertyIsReadOnlyException

已尝试设置只读属性。

SettingsPropertyWrongTypeException

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

注解

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

首次访问属性时， SettingsBase 实例将查找与所请求属性共享同一提供程序的所有其他属性。 然后，实例 SettingsBase 将调用提供程序，向其传递表示提供程序应检索的数据的对象集 SettingsProperty 。

请注意，如果 IsSynchronized 为 true，则索引器将以线程安全的方式获取和设置属性数据。 默认情况下， SettingsBase 实例不是线程安全的。 但是，可以调用 Synchronized，传入 SettingsBase 实例，使 SettingsBase 索引器以线程安全的方式运行。

另请参阅

• IsReadOnly