Język

ApplicationSettingsBase.Item[String] Właściwość

Definicja

Pobiera lub ustawia wartość określonej właściwości ustawień aplikacji.

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

Parametry

propertyName
String

Element String zawierający nazwę właściwości, do których ma być uzyskiwany dostęp.

Wartość właściwości

Jeśli zostanie znaleziona, wartość właściwości nazwanych ustawień; w przeciwnym razie, null.

Wyjątki

Nie ma żadnych właściwości skojarzonych z bieżącą otoczką lub nie można odnaleźć określonej właściwości.

Podjęto próbę ustawienia właściwości tylko do odczytu.

Podana wartość jest typu niezgodnego z właściwością settings podczas operacji zestawu.

Nie można przeanalizować pliku konfiguracji.

Uwagi

Właściwość Item[] , znana również jako indeksator, jest rutynowo używana w klasie otoki ustawień pochodzącej z ApplicationSettingsBaseklasy . Item[] Wiąże właściwość publiczną klasy otoki z odpowiednią właściwością ustawień.

Item[] wywołuje kilka zdarzeń w zależności od wykonywanej operacji:

  • Przy pierwszym pobraniu właściwości jest wywoływane SettingsLoaded zdarzenie.

  • Po ustawieniu właściwości zdarzenie OnSettingChanging jest zgłaszane. Jeśli program obsługi nie anuluje zdarzenia, zostanie ustawiona wartość właściwości i PropertyChanged zostanie zgłoszone zdarzenie.

Dotyczy

Zobacz też