Způsob ukládání a načítání vlastních informací z konfiguračního souboru aplikace pomocí Visual C#

Překlady článku Překlady článku
ID článku: 815786 - Produkty, které se vztahují k tomuto článku.
Pro Microsoft Visual Basic.NET verze tohoto článek naleznete v tématu 313405.
Tento článek se týká následujících společnosti Microsoft.NET Framework Obor názvů knihovny tříd:
  • System.Configuration
Rozbalit všechny záložky | Minimalizovat všechny záložky

Na této stránce

Souhrn

Tento článek popisuje, jak ukládat vlastní informace soubor konfigurace (.config), který můžete načíst později za běhu pomocí jeho přidruženou aplikaci. To je užitečné v případě, že je nutné definovat data, která je přidruženým k aplikaci.

Požadavky

Následující seznam obsahuje doporučený hardware, software, síťové infrastruktury a aktualizace service Pack, které potřebujete:
  • Systém Microsoft Windows 2000, Windows XP, Windows Server 2003, Windows Vista nebo Windows Server 2008
  • Microsoft Visual C#
Tento článek předpokládá, že jste obeznámeni s následujícími témata:
  • Extensible Markup Language (XML)
  • .NET konfigurační soubory

Vytvoření aplikace konzoly, který přečte obsah konfiguračního souboru

Aplikace můžete uložit nastavení v konfiguračním souboru, který je spojen s aplikací. Konfigurační soubory jsou uloženy ve formátu XML formát.

Na System.Configuration aSystem.Collections.SPECIALIZED obory názvů Microsoft.NET Framework zahrnují nezbytné třídy k načtení informací z.NET konfiguračního souboru v době spuštění.

Vytvoření aplikace konzoly, který čte obsah přidružen konfigurační soubor v době spuštění, postupujte kroky:
  1. Spusťte aplikaci Visual Studio.NET nebo Visual Studio 2005.
  2. V Soubor příkazNovýa klepněte na tlačítko Projekt.
  3. Klepněte na tlačítko Visual C# ve skupinovém rámečkuTypy projektůa klepněte na tlačítko Konzoly Aplikace ve skupinovém rámečku Šablony. Název projektu ConConfig. Ve výchozím nastavení Visual C# vytvoří třídu s názvem programu.

    Poznámka: V aplikaci Visual Studio.NET 2003, klepněte na tlačítko Visual C# projekty ve skupinovém rámečkuTypy projektůa klepněte na tlačítko Konzoly Aplikace ve skupinovém rámečku Šablony. Název projektuConConfig. Ve výchozím nastavení Visual C# vytvoří třídu s názvem Class1.
  4. Přesvědčte se, zda okna v aplikaci Solution Explorer viditelné. Pokud není viditelný, stiskněte kombinaci kláves CTRL + ALT + L.
  5. V aplikaci Solution Explorer klepněte pravým tlačítkem myši na název projektu, klepněte na tlačítko Přidata klepněte na tlačítko Nová položka.
  6. V Přidat novou položku Vyberte položkuSoubor XML.
  7. V Název typ textového poleApp.configa klepněte na tlačítkoPřidat.

    Poznámka: V aplikaci Visual Studio.NET 2003, klepněte na tlačítko Otevřít.
  8. Konfigurační soubor aplikace můžete použít ke shromažďování Nastavení vlastních aplikací, které uložíte ve formátu klíč hodnota. Můžete zahrnout <add></add> prvky v <appsettings></appsettings> oddíl přidružen konfigurační soubor. Každá dvojice klíč hodnota má jeden <add></add> prvek. Aplikace <add></add> prvek má následující formát:
    <add key="Key0" value="0" />
    Přidat <appsettings></appsettings> oddíl s <add></add> prvky konfiguračního souboru mezi<configuration></configuration> a tagy.

    Například zahrnuje následující konfigurační soubor <appsettings></appsettings> oddíl, který určuje tři páry klíč hodnota:
    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
       <appSettings>
          <add key="Key0" value="0" />
          <add key="Key1" value="1" />
          <add key="Key2" value="2" />
       </appSettings>
    </configuration>
    
  9. V aplikaci Solution Explorer poklepejte naProgram.cs Zobrazí se okno kód. Přidejte následující příkazy v modulu kódu.

    Poznámka: Tyto příkazy se musí objevit před příkazy v soubor.
    using System.Configuration;
    using System.Collections.Specialized;
  10. Přidáte odkaz na System.Configuration.dll. Chcete-li to provést, postupujte takto:
    1. V Projekt nabídky, klepněte na tlačítko Přidat odkaz.
    2. V Přidat odkaz Dialogové okno Klepněte .NET na kartě.
    3. Vyhledejte a vyberte název System.Configuration komponent.
    4. Klepněte na tlačítko OK.
  11. Pro uložení hodnot z konfigurační soubor klíče<appsettings></appsettings> oddíl konfiguračního souboru deklarovat řetězcové proměnné v Hlavní část takto:
     string  sAttr ;
  12. Získat hodnoty pro zadaný klíč <appsettings></appsettings> v části Použití konfiguračního souboru Získat Metoda AppSettings Vlastnost ConfigurationManager Třída. Na ConfigurationManager Třída je v System.Configuration obor názvů. Když AppSettings.Get Metoda přijímá vstupní parametr řetězec, který obsahuje klíč, aplikace načte hodnotu, která je spojena s klíčem.

    Na Následující kód načte hodnotu Key0 atribut z přidružen konfigurační soubor. Kód poté umístí tuto hodnotu v sAttr řetězcové proměnné. Pokud klíč neexistuje pro tuto hodnotu nic je uložena v sAttr.
    sAttr = ConfigurationManager.AppSettings.Get("Key0");
  13. Zobrazí hodnotu, aplikace načte v Okna konzoly, použijte Console.WriteLine takto:
    Console.WriteLine("The value of Key0 is "+sAttr);
  14. Můžete použít jeden odkaz na AppSettings dvojice vlastnost načíst všechny klíč hodnota v<appsettings></appsettings> sekce. Při použití AppSettings Vlastnost aplikace vrátí všechny přidružené dvojice. Tyto dvojice jsou uloženy v Kolekce NameValueCollection typ. Na Kolekce NameValueCollection obsahuje klíč hodnota položky pro každý klíč, který aplikace načte. Na Kolekce NameValueCollection Třída je v System.Collections.SPECIALIZED obor názvů.
    NameValueCollection sAll ;
    sAll = ConfigurationManager.AppSettings;
  15. Na AllKeys Vlastnost Kolekce NameValueCollection pole řetězců, který obsahuje položku pro každý klíč, který odkazuje aplikace načte. Použití foreach konstrukce pro iteraci AllKeys pole pro každý klíč, který aplikace načte přístup. Každý klíč Položka AllKeys je datový typ řetězec.

    Uvnitř foreach konstrukce, použití Console.WriteLine Zobrazit klíč a přidružené hodnoty v konzole okno. Aktuální klíč, který zpracovává žádosti je "s". Použít jako index v sAllNameValueCollection získání přidružené hodnoty.
       foreach (string s in sAll.AllKeys)
          Console.WriteLine("Key: "+ s + " Value: " + sAll.Get(s));
       Console.ReadLine();

Úplný výpis kódu

using System;
using System.Configuration;
using System.Collections.Specialized;

namespace ConConfig
{
    class Program
    {
        static void Main(string[] args)
        {
            string sAttr;

            // Read a particular key from the config file            
            sAttr = ConfigurationManager.AppSettings.Get("Key0");
            Console.WriteLine("The value of Key0: " + sAttr);

            // Read all the keys from the config file
            NameValueCollection sAll;
            sAll = ConfigurationManager.AppSettings;

            foreach (string s in sAll.AllKeys)
                Console.WriteLine("Key: " + s + " Value: " + sAll.Get(s));
           Console.ReadLine();
       }
    }
}
Poznámka: Tento kód je zaměření.Rozhraní .NET Framework 2.0. Pokud používáte.Rozhraní .NET Framework 1.0 nebo.NET Framework 1.1, změnit všechny výskyty ConfigurationManager Třída ConfigurationSettings.

Dokončete konfiguraci souboru se seznamem (ConConfig.exe.config)

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
   <appSettings>
      <add key="Key0" value="0" />
      <add key="Key1" value="1" />
      <add key="Key2" value="2" />
   </appSettings>
</configuration>

Ověřte, zda funguje

Stisknutím klávesy F5 spustit kód. Okna konzoly, které má být zobrazeno klíč hodnota páry z <appsettings></appsettings> část přidružen konfigurační soubor takto:
The value of Key0: 0
Key: Key0 Value:0
Key: Key1 Value:1
Key: Key2 Value:2
		

Poradce při potížích

  • Konfigurační soubor je uložen ve formátu XML. Ujistěte se, že že je dodržovat všechna pravidla syntaxe XML. Nezapomeňte, že XML je velká a malá písmena. Pokud XML není správně utvořen, nebo pokud je prvek chybně, zobrazí Výjimka System.Configuration.Configuration.

    Přidáte-li například klíčovou vlastností <add></add> prvek s velká písmena "K" namísto malých "k", nebo pokud na <appsettings></appsettings> části se zobrazí jako <appsettings></appsettings> (s velkými písmeny "A" namísto malými "a"), obdržíte chybová zpráva.
  • Konfigurační soubor musí být uložen ve stejné složce jako jeho přidruženou aplikaci.
  • Je nutné použít následující syntaxi pro konfiguraci název souboru:
    ApplicationName.ApplicationType.config
    kde ApplicationName název aplikace, ApplicationType Typ aplikace (například exe) a .config je požadována přípona.

Odkazy

Další informace naleznete v následujících Microsoft Developer Webové servery Network (MSDN):
Vlastnost ConfigurationSettings.AppSettings
http://msdn.microsoft.com/en-us/library/System.Configuration.configurationsettings.appSettings (vs.71) .aspx
System.Configuration Obor názvů
http://msdn.microsoft.com/en-us/library/System.Configuration (vs.71) .aspx

Vlastnosti

ID článku: 815786 - Poslední aktualizace: 20. května 2011 - Revize: 5.0
Informace v tomto článku jsou určeny pro produkt:
  • Microsoft Visual C# 2008 Express Edition
  • Microsoft Visual C# 2005 Express Edition
  • Microsoft Visual C# .NET 2003 Standard Edition
  • Microsoft Visual C# .NET 2002 Standard Edition
Klíčová slova: 
kbsweptvs2008 kbcollections kbcollectionclass kbconfig kbnamespace kbhowtomaster kbprogramming kbmt KB815786 KbMtcs
Strojově přeložený článek
Důležité: Tento článek byl přeložen pomocí software společnosti Microsoft na strojový překlad, ne profesionálním překladatelem. Společnost Microsoft nabízí jak články přeložené překladatelem, tak články přeložené pomocí software na strojový překlad, takže všechny články ve Znalostní databázi (Knowledge Base) jsou dostupné v češtině. Překlad pomocí software na strojový překlad ale není bohužel vždy dokonalý. Obsahuje chyby ve skloňování slov, skladbě vět, nebo gramatice, podobně jako když cizinci dělají chyby při mluvení v češtině. Společnost Microsoft není právně zodpovědná za nepřesnosti, chyby nebo škody vzniklé chybami v překladu, nebo při použití nepřesně přeložených instrukcí v článku zákazníkem. Společnost Microsoft aktualizuje software na strojový překlad, aby byl počet chyb omezen na minimum.
Projděte si také anglickou verzi článku:815786

Dejte nám zpětnou vazbu

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com