SettingsBase.Item[String] 屬性

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

來源:

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