Egyéni vezérlők alkalmazásbeállításai

Bizonyos feladatokat el kell végeznie, hogy az egyéni vezérlők megőrizhessenek alkalmazásbeállításokat, amikor a vezérlőket külső alkalmazásokban üzemeltetik.

Az Alkalmazásbeállítások funkcióval kapcsolatos dokumentáció nagy része azzal a feltételezéssel van megírva, hogy önálló alkalmazást hoz létre. Ha azonban olyan vezérlőt hoz létre, amelyet más fejlesztők fognak üzemeltetni az alkalmazásaikban, néhány további lépést kell tennie ahhoz, hogy a vezérlő megfelelően megőrizze a beállításokat.

Alkalmazásbeállítások és egyéni vezérlők

Ahhoz, hogy a vezérlő helyesen megőrizze a beállításait, a folyamatot saját dedikált alkalmazásbeállítások burkolóosztályának létrehozásával kell beágyaznia, amely a ApplicationSettingsBase-ból származik. Emellett a fő vezérlőosztálynak implementálnia kell a IPersistComponentSettings. Az interfész számos tulajdonságot, valamint két metódust, LoadComponentSettings és SaveComponentSettingstartalmaz. Ha a vezérlőt a Visual Studióban a Windows Forms Designer használatával adja hozzá egy űrlaphoz, a Windows Forms automatikusan meghívja LoadComponentSettings a vezérlő inicializálásakor; SaveComponentSettings magát kell meghívnia a vezérlés Dispose metódusában.

Emellett a következőket kell implementálnia ahhoz, hogy az egyéni vezérlők alkalmazásbeállításai megfelelően működjenek a tervezési idejű környezetekben, például a Visual Studióban:

1. Egyéni alkalmazásbeállítási osztály egy konstruktorral, amely egyetlen paraméterként IComponent vesz igénybe. Ebben az osztályban mentheti és betöltheti az összes alkalmazásbeállítást. Az osztály új példányának létrehozásakor a konstruktoron keresztül adja át az egyéni vezérlőt.

2. Ezt az egyéni beállításosztályt a vezérlő létrehozása és űrlapra való elhelyezése után hozza létre, például az űrlap Load eseménykezelőjében.

Az egyéni beállításosztályok létrehozásáról az Útmutató: Alkalmazásbeállítások létrehozásacímű témakörben talál útmutatást.

Beállításkulcsok és megosztott beállítások

Egyes vezérlők többször is használhatók ugyanazon űrlapon belül. A legtöbb esetben azt szeretné, hogy ezek a vezérlők megőrizzék a saját egyéni beállításait. A SettingsKey tulajdonsággal a IPersistComponentSettings-en megadhat egy egyedi karakterláncot, amely az űrlap vezérlőelemeinek több verzióját egyértelműsíti.

A legegyszerűbb módja SettingsKey megvalósításának a vezérlő Name tulajdonságának használata a SettingsKey-hez. A vezérlő beállításainak betöltésekor vagy mentésekor a SettingsKey értékét átadja a SettingsKey osztály ApplicationSettingsBase tulajdonságának. Az alkalmazásbeállítások ezt az egyedi kulcsot használják, ha a felhasználó beállításait XML-ben megőrzi. Az alábbi példakód bemutatja, hogyan nézhet ki egy <userSettings> szakasz egy CustomControl1 nevű egyéni vezérlő esetében, amely a Text tulajdonságához kapcsolódó beállítást ment.

<userSettings>
    <CustomControl1>
        <setting name="Text" serializedAs="string">
            <value>Hello, World</value>
        </setting>
    </CustomControl1>
</userSettings>

Azok a vezérlők, amelyek nem adnak meg értéket a SettingsKey-hoz, ugyanazt a beállítást fogják alkalmazni.

Lásd még

• ApplicationSettingsBase
• IPersistComponentSettings
• alkalmazásbeállítások architektúrája