Dela via


Konfigurera appar med hjälp av konfigurationsfiler

Notera

Den här artikeln är specifik för .NET Framework. Det gäller inte för nyare implementeringar av .NET, inklusive .NET 6 och senare versioner.

.NET Framework ger utvecklare och administratörer kontroll och flexibilitet över hur program körs genom konfigurationsfiler. Konfigurationsfiler är XML-filer som kan ändras efter behov. En administratör kan styra vilka skyddade resurser som ett program kan komma åt, vilka versioner av sammansättningar ett program ska använda och var fjärranslutna program och objekt finns. Utvecklare kan placera inställningar i konfigurationsfiler, vilket eliminerar behovet av att kompilera om ett program varje gång en inställning ändras. I det här avsnittet beskrivs vad som kan konfigureras och varför det kan vara användbart att konfigurera ett program.

Not

Hanterad kod kan använda klasserna i System.Configuration namnområdet för att läsa inställningar från konfigurationsfilerna, men inte för att skriva inställningar till dessa filer.

Den här artikeln beskriver syntaxen för konfigurationsfiler och innehåller information om de tre typerna av konfigurationsfiler: dator, program och säkerhet.

Konfigurationsfilformat

Konfigurationsfiler innehåller element, som är logiska datastrukturer som anger konfigurationsinformation. I en konfigurationsfil använder du taggar för att markera början och slutet av ett element. Elementet <runtime> består till exempel av <runtime>underordnade element</runtime>. Ett tomt element skrivs som <runtime/> eller <runtime></runtime>.

Precis som med alla XML-filer är syntaxen i konfigurationsfiler skiftlägeskänslig.

Du anger konfigurationsinställningar med fördefinierade attribut, som är namn/värde-par i ett elements starttagg. I följande exempel anges två attribut (version och href) för elementet <codeBase>, som anger var runtime kan hitta en assembly (mer information finns i Ange en assemblys plats).

<codeBase version="2.0.0.0"
          href="http://www.litwareinc.com/myAssembly.dll"/>

Datorkonfigurationsfiler

Datorkonfigurationsfilen Machine.configinnehåller inställningar som gäller för en hel dator. Den här filen finns i installationssökvägen för runtime-miljön %%\Config-katalogen. Machine.config innehåller konfigurationsinställningar för maskinomfattande sammansättningsbindning, inbyggda fjärrkommunikationskanaleroch ASP.NET.

Konfigurationssystemet letar först i datorkonfigurationsfilen efter <appInställningar> element och andra konfigurationsavsnitt som en utvecklare kan definiera. Den tittar sedan i programkonfigurationsfilen. För att hålla datorkonfigurationsfilen hanterbar är det bäst att placera de här inställningarna i programkonfigurationsfilen. Att placera inställningarna i datorkonfigurationsfilen kan dock göra systemet mer underhållsbart. Om du till exempel har en komponent från tredje part som både klient- och serverprogrammet använder är det enklare att placera inställningarna för komponenten på ett ställe. I det här fallet är datorkonfigurationsfilen lämplig plats för inställningarna, så du har inte samma inställningar i två olika filer.

Obs

När du distribuerar ett program med XCOPY kopieras inte inställningarna i datorkonfigurationsfilen.

Mer information om hur den vanliga språkkörningen använder datorkonfigurationsfilen för sammansättningsbindning finns i How the Runtime Locates Assemblies.

Programkonfigurationsfiler

En programkonfigurationsfil innehåller inställningar som är specifika för en app. Den här filen innehåller konfigurationsinställningar som Common Language Runtime läser (till exempel sammansättningsbindningspolicy, fjärrkommunikationsobjekt och så vidare) och inställningar som appen kan läsa.

Namnet och platsen för programkonfigurationsfilen beror på appens värd, vilket kan vara något av följande:

  • Körbar app med värd.

    Dessa appar har två konfigurationsfiler: en källkonfigurationsfil som ändras av utvecklaren under utvecklingen och en utdatafil som distribueras med appen.

    Som standard är namnet på källkonfigurationsfilen App.config. När du skapar ett .NET Framework-projekt i Visual Studio läggs en App.config fil automatiskt till i projektet. Du kan också lägga till en fil manuellt genom att välja File>New File. Placera App.config-filen i projektkatalogen och ange egenskapen Kopiera till utdatakatalog till Kopiera alltid eller Kopiera om nyare.

    För att skapa utdatakonfigurationsfilen som distribueras med appen kopierar Visual Studio källkonfigurationsfilen till katalogen där den kompilerade sammansättningen placeras. Den här filen heter <yourappname>.exe.config. En app med namnet myApp.exe har till exempel en utdatakonfigurationsfil med namnet myApp.exe.config.

    I vissa fall kan Visual Studio ändra utdatakonfigurationsfilen. För mer information, se Omdirigeringsversioner på appnivå.

  • ASP.NET-värdbaserad app.

    Mer information om ASP.NET konfigurationsfiler finns i ASP.NET Konfigurationsinställningar.

Säkerhetskonfigurationsfiler

Säkerhetskonfigurationsfiler innehåller information om kodgruppshierarkin och behörighetsuppsättningar som är associerade med en principnivå. Vi rekommenderar starkt att du använder verktyget Code Access Security Policy (Caspol.exe) för att ändra säkerhetsprincipen för att säkerställa att principändringar inte skadar säkerhetskonfigurationsfilerna.

Not

Från och med .NET Framework 4 finns säkerhetskonfigurationsfilerna endast om säkerhetsprincipen har ändrats.

Säkerhetskonfigurationsfilerna finns på följande platser:

  • Konfigurationsfil för företagsprinciper: %runtime-installationsväg%\Config\Enterprisesec.config

  • Konfigurationsfil för datorprincip: %%\Config\Security.config

  • Konfigurationsfil för användarprinciper: %USERPROFILE%\Application data\Microsoft\CLR security config\vxx.xx\Security.config

Se även