Alkalmazás Gépház séma
Az alkalmazásbeállítások lehetővé teszik, hogy egy Windows-űrlap vagy ASP.NET-alkalmazás tárolja és kérje le az alkalmazás hatókörébe tartozó és a felhasználó által hatókörön belüli beállításokat. Ebben az összefüggésben a beállítás az alkalmazásra vagy az aktuális felhasználóra jellemző bármely információ – az adatbázistól kezdve a kapcsolati sztring a felhasználó által előnyben részesített alapértelmezett ablakméretig.
Alapértelmezés szerint a Windows Forms-alkalmazások alkalmazásbeállításai az LocalFileSettingsProvider osztályt használják, amely a .NET konfigurációs rendszert használja a beállítások XML-konfigurációs fájlban való tárolásához. Az alkalmazásbeállítások által használt fájlokról további információt az Alkalmazás Gépház architektúra című témakörben talál.
Fontos
A .NET-keretrendszer által definiált konfigurációs szakaszok többsége már nem működik a .NET 6+ és a .NET Core verziókban. ConfigurationManager csak a kompatibilitás érdekében van megadva. Az app.config helyett a modern .NET az appsettings.json fájlt használja az alkalmazásbeállításokhoz. Lásd: Modernizálás a .NET-re való frissítés után .NET-keretrendszer.
Érdemes lehet eltávolítani a használatot az app.config-ban, és meghívni a megfelelő API-t, ha van ilyen, ugyanezt a beállítást. További információ: Konfiguráció a .NET-ben.
Az alkalmazásbeállítások a következő elemeket határozzák meg az általa használt konfigurációs fájlok részeként.
| Elem | Leírás |
|---|---|
| <alkalmazás Gépház> | Az alkalmazáshoz tartozó összes <beállításcímkét> tartalmazza. |
| <felhasználó Gépház> | Az aktuális felhasználóra vonatkozó összes <beállításcímkét> tartalmazza. |
| <Beállítás> | Egy beállítást határoz meg. Gyermek vagy alkalmazás Gépház> vagy <felhasználó Gépház>.< |
| <value> | Meghatározza egy beállítás értékét. A beállítás> gyermeke<. |
<alkalmazás Gépház> elem
Ez az elem az ügyfélszámítógépen található alkalmazás egy példányára jellemző összes <beállításcímkét> tartalmazza. Nem definiál attribútumokat.
<felhasználó Gépház> elem
Ez az elem tartalmazza az alkalmazást jelenleg használó felhasználóra jellemző összes beállításcímkét>.< Nem definiál attribútumokat.
<beállítási> elem
Ez az elem definiál egy beállítást. Az alábbi attribútumokkal rendelkezik.
| Attribútum | Ismertetés |
|---|---|
| név | Szükséges. A beállítás egyedi azonosítója. A Visual Studióban létrehozott Gépház a rendszer a névvel ProjectName.Properties.Settingsmenti. |
| szerializeA | Szükséges. Az érték szöveggé való szerializálásához használható formátum. Az érvényes értékek a következők: - string. Az érték sztringként szerializálva van egy TypeConverter.- xml. Az érték szerializálása XML-szerializálással történik.- binary. Az érték bináris szerializálással szövegkódolt binárisként van szerializálva.- custom. A beállításszolgáltató ismeri ezt a beállítást, szerializálja és szerializálja. |
Adja hozzá az alkalmazásban létrehozott beállítások nevét Gépház> a fájl tetején található< configSections> elem alatti bejegyzésként.< Például:
<configuration>
<configSections>
<sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
<section name="WindowsFormsApp1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
<section name="WindowsFormsApp1.Properties.MyCustomSettings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
</sectionGroup>
</configSections>
...
</configuration>
<értékelem>
Ez az elem egy beállítás értékét tartalmazza.
Példa
Az alábbi példa egy alkalmazásbeállításokat tartalmazó fájlt mutat be, amely két alkalmazáshatókörű beállítást és két felhasználó hatókörű beállítást határoz meg:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">
<section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</sectionGroup>
<sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">
<section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" />
</sectionGroup>
</configSections>
<applicationSettings>
<WindowsApplication1.Properties.Settings>
<setting name="Cursor" serializeAs="String">
<value>Default</value>
</setting>
<setting name="DoubleBuffering" serializeAs="String">
<value>False</value>
</setting>
</WindowsApplication1.Properties.Settings>
</applicationSettings>
<userSettings>
<WindowsApplication1.Properties.Settings>
<setting name="FormTitle" serializeAs="String">
<value>Form1</value>
</setting>
<setting name="FormSize" serializeAs="String">
<value>595, 536</value>
</setting>
</WindowsApplication1.Properties.Settings>
</userSettings>
</configuration>
