SettingsBase.Item[String] 屬性

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v11.0.0-rc.1.26425.128

來源:

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 A 包含可存取的物業名稱。

屬性值

Object

如果找到，則是命名設定屬性的值。

例外狀況

SettingsPropertyNotFoundException

目前物件沒有任何屬性相關聯，或是找不到指定的屬性。

SettingsPropertyIsReadOnlyException

曾嘗試設定唯讀屬性。

SettingsPropertyWrongTypeException

在設定操作中，所提供的值型態與設定屬性不相容。

備註

這個 Item[] 屬性，也稱為索引器，經常用於由 衍生出 SettingsBase的 settings 類別中。 該 Item[] 屬性將類別的公共屬性綁定到對應的設定屬性。

第一次存取物件時，實 SettingsBase 例會找到所有與該物件共用相同提供者的其他物件。 SettingsBase實例接著會呼叫提供者，並將代表提供者應該檢索的資料的物件集合SettingsProperty傳遞給它。

注意，索引器會以執行緒安全的方式取得並設定屬性資料，若 IsSynchronized 為 true。 預設實 SettingsBase 例並非執行緒安全。 不過，你可以呼叫 Synchronized，並在實 SettingsBase 例中傳遞，使索引器以 SettingsBase 執行緒安全的方式運作。

另請參閱

• IsReadOnly