Megosztás a következőn keresztül:

Alkalmazásbeállítások kezelése (.NET)

Az alkalmazásbeállítások lehetővé teszik az alkalmazásadatok dinamikus tárolását. Az alkalmazásbeállítások segítségével az ügyfélszámítógépek olyan információkat tárolhatnak, amelyeket futásidőben nem szabad belefoglalni az alkalmazáskódba. Az alkalmazásbeállítások tartalmazhatnak kapcsolati sztringeket, felhasználói beállításokat és egyebeket.

Jegyzet

Az alkalmazásbeállítások lecserélik a Visual Studio korábbi verzióiban használt dinamikus tulajdonságokat.

Minden alkalmazásbeállításnak egyedi névvel kell rendelkeznie. A név lehet betűk, számok vagy aláhúzás tetszőleges kombinációja. A név nem kezdődhet számmal, és nem tartalmazhat szóközöket. A név a Name tulajdonságon keresztül változik.

Az alkalmazásbeállítások bármilyen adattípusként tárolhatók, ami XML formátumba szerializálható vagy ami a TypeConverterToString/FromStringinterfészeket implementálja. A leggyakoribb típusok a String, Integerés Boolean. Az értékeket Color, Objectvagy kapcsolati sztringként is tárolhatja.

Az alkalmazásbeállítások egy értéket is tárolnak. Az érték a Érték tulajdonsággal van beállítva, és meg kell egyeznie a beállítás adattípusával.

Emellett az alkalmazásbeállítások egy űrlap vagy vezérlőelem tulajdonságához is köthetők a tervezéskor.

A hatókörön alapuló alkalmazásbeállításoknak két típusa van:

  • alkalmazás hatókörébe tartozó beállítások olyan információkhoz használhatók, mint egy webszolgáltatás URL-címe vagy egy adatbázis kapcsolati sztringje. Ezek az értékek az alkalmazáshoz vannak társítva. Ezért a felhasználók futásidőben nem módosíthatják őket.

  • felhasználói hatókörű beállítások olyan információkhoz használhatók, mint például egy űrlap utolsó pozíciójának megőrzése vagy a betűtípus-beállítások megőrzése. A felhasználók futásidőben módosíthatják ezeket az értékeket.

A beállítás típusát a Hatókör tulajdonság használatával módosíthatja.

A projektrendszer két XML-fájlban tárolja az alkalmazásbeállításokat:

  • Az első alkalmazásbeállítás létrehozásakor tervezési időben jön létre egy app.config fájl.

  • Egy user.config fájl, amely futásidőben jön létre, amikor az alkalmazást futtató felhasználó módosítja a felhasználói beállítások értékét

A felhasználói beállítások módosításait csak akkor írja a rendszer a lemezre, ha az alkalmazás kifejezetten erre a metódust hívja meg.

Alkalmazásbeállítások létrehozása tervezéskor

Tervezéskor kétféleképpen hozhat létre alkalmazásbeállításokat:

  • Használja a Project DesignerBeállítások lapját.

  • Használja a Tulajdonságok ablakot egy űrlaphoz vagy vezérlőelemhez, amely lehetővé teszi, hogy egy beállítást egy tulajdonsághoz kössön.

Ha alkalmazáshatókörű beállítást hoz létre (például adatbázis-kapcsolati sztringet vagy kiszolgálói erőforrásokra mutató hivatkozást), a Visual Studio a <applicationSettings> címkével menti azt a app.config fájlba. A kapcsolati karakterláncok a <connectionStrings> címke alatt vannak mentve.

Ha felhasználói hatókörű beállítást hoz létre (például alapértelmezett betűtípust, kezdőlapot vagy ablakméretet), a Visual Studio app.config fájlba menti a <userSettings> címkével.

Fontos

Ha a kapcsolati sztringeket app.configtárolja, óvintézkedéseket kell tenni annak érdekében, hogy a kapcsolati sztringben ne jelenjenek meg bizalmas információk, például jelszavak vagy kiszolgálói útvonalak.

Ha külső forrásból, például egy felhasználótól veszi át a kapcsolati sztring adatait, és megadja a felhasználói azonosítóját és jelszavát, győződjön meg arról, hogy a kapcsolati sztring létrehozásához használt értékek nem tartalmaznak további kapcsolati sztringparamétereket, amelyek megváltoztatják a kapcsolat viselkedését.

Fontolja meg a védett konfigurációs funkció használatát a konfigurációs fájl bizalmas adatainak titkosításához. További információ: Kapcsolati adatok védelme.

Jegyzet

Mivel az osztálytárakhoz nincs konfigurációs fájlmodell, az alkalmazásbeállítások nem érvényesek az osztálytár-projektekre. Kivételt képez egy Visual Studio Tools for Office Runtime DLL-projekt, amely konfigurációs fájllal rendelkezhet.

Testre szabott beállításfájlok használata

A beállítások csoportjainak kényelmes kezelése érdekében testre szabott beállításfájlokat adhat hozzá a projekthez. Az egyetlen fájlban található beállításokat a rendszer egységként tölti be és menti. A gyakran használt és ritkán használt csoportok beállításainak külön fájlokban való tárolása időt takaríthat meg a beállítások betöltése és mentése során.

Hozzáadhat például egy SpecialSettings.settings fájlt a projekthez. Bár a SpecialSettings osztály nem jelenik meg a My névtérben, Kód megtekintése elolvashatja a Partial Class SpecialSettingstartalmazó egyéni beállításfájlt.

A Beállítások tervezője először megkeresi a Settings.settings fájlt, amelyet a projektrendszer létrehoz. Ez a Settings.settings fájl az alapértelmezett fájl, amelyet a Project Designer a Beállítások lapon jelenít meg. A Settings.settings fájl a Visual Basic-projektek Saját projekt mappájában, a Visual C#-projektek Tulajdonságok mappájában található. A Project Designer ezután megkeresi a projekt gyökérmappájában található egyéb beállításfájlokat. Ezért oda kell helyeznie az egyéni beállításfájlt. Ha .settings fájlt ad hozzá a projekt más részén, a Project Designer nem találja.

Alkalmazásbeállítások elérése vagy módosítása futtatókörnyezetben a Visual Basicben

A Visual Basic-projektekben az alkalmazásbeállítások futásidőben érhetők el a My.Settings objektum használatával. A Beállítások lapon válassza a Kód megtekintése gombot a Settings.vb fájl megtekintéséhez. Settings.vb meghatározza a Settings osztályt, amely lehetővé teszi az események kezelését a beállításosztályon:

A Settings.vbSettings osztálya egy részleges osztály, amely csak a felhasználó által birtokolt kódot jeleníti meg, nem pedig a teljes generált osztályt. További információ az alkalmazásbeállítások My.Settings objektum használatával való eléréséről: Access alkalmazásbeállítások (.NET-keretrendszer).

A felhasználó által futtatáskor módosított felhasználói beállítások értékeit( például egy űrlap pozícióját) egy user.config fájl tárolja. Az alapértelmezett értékek továbbra is app.configvannak mentve.

Ha a futtatókörnyezetben módosítja a felhasználó által megadott beállításokat, például az alkalmazás tesztelése során, és alaphelyzetbe szeretné állítani ezeket a beállításokat az alapértelmezett értékükre, válassza a Szinkronizálás gombot.

Javasoljuk, hogy a beállítások eléréséhez használja a My.Settings objektumot és az alapértelmezett .settings fájlt. A Settings Designer használatával tulajdonságokat rendelhet a beállításokhoz, és a felhasználói beállítások automatikusan mentésre kerülnek az alkalmazás leállítása előtt. A Visual Basic-alkalmazás azonban közvetlenül is hozzáférhet a beállításokhoz. Ebben az esetben hozzá kell férnie a MySettings osztályhoz, és egy egyéni .settings fájlt kell használnia a projekt gyökerében. Az alkalmazás befejezése előtt mentenie kell a felhasználói beállításokat, ahogyan azt egy C#-alkalmazás esetében tenné, az alábbi szakaszban leírtak szerint.

Alkalmazásbeállítások elérése vagy módosítása futásidőben a C-ben#

A Visual Basicen kívül más nyelveken, például a C#-ban közvetlenül kell hozzáférnie a Settings osztályhoz, ahogyan az a következő Visual C# példában látható.

Properties.Settings.Default.FirstUserSetting = "abc";

A felhasználói beállítások megőrzéséhez explicit módon meg kell hívnia ennek a burkolóosztálynak a Save metódusát. Ezt általában a fő űrlap Closing eseménykezelőjében teheti meg. Az alábbi C#-példa a Save metódus hívását mutatja be.

Properties.Settings.Default.Save();

Az alkalmazásbeállítások Settings osztályon keresztüli eléréséről a Alkalmazásbeállítások áttekintése (.NET-keretrendszer)című cikkben olvashat.

Alkalmazások migrálása a .NET-keretrendszerből a .NET-be

A .NET-keretrendszer a app.config fájllal tölti be az alkalmazás beállításait, például a kapcsolati sztringeket és a naplószolgáltató konfigurációját. A modern .NET a appsettings.json fájlt használja az alkalmazásbeállításokhoz. Ha többet szeretne megtudni arról, hogyan konvertálhatók a app.config fájlok appsettings.jsonformátumba, tekintse meg a .NET Frameworkről .NET-re való frissítés utáni modernizálás témakört.

Kapcsolódó tartalom