Você está offline; aguardando reconexão

Como armazenar e recuperar informações personalizadas de um arquivo de configuração de aplicativo usando translation from VPE for Csharp Visual

IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Obrigado.

Clique aqui para ver a versão em Inglês deste artigo: 815786
Para uma versão deste artigo do Microsoft Visual Basic. NET, consulte 313405.
Este artigo se refere para o seguinte Microsoft .NET Framework Class Library namespace:       
  • System.Configuration
Sumário
Este artigo descreve como armazenar informações personalizadas em um arquivo de configuração (config) que você pode recuperar mais tarde durante tempo de execução, seu aplicativo associado. Isso é útil quando você deve definir dados que está associados a um aplicativo.

back to the top

Requisitos

A lista a seguir descreve o hardware recomendado, software, infra-estrutura de rede e service packs que você precisa:
  • Microsoft Windows 2000, Windows XP, Windows Server 2003, Windows Vista ou Windows Server 2008
  • Microsoft Visual translation from VPE for Csharp
Este artigo pressupõe que você esteja familiarizado com os seguintes tópicos:
  • Linguagem de marcação extensível (XML)
  • Arquivos de configuração do .NET
back to the top

Criar um aplicativo de console que leituras o conteúdo de um arquivo de configuração

Você pode armazenar configurações de aplicativo no arquivo de configuração está associado com o aplicativo. Arquivos de configuração são salvos em XML formato.

Os namespaces System.Collections.Specialized no Microsoft .NET Framework e o System.Configuration incluem as classes necessárias para recuperar informações de um arquivo de configuração do aplicativo .NET durante o tempo de execução.

Para criar um aplicativo de console que lê o conteúdo de um arquivo de configuração associada durante o tempo de execução, execute estas etapas:
  1. Inicie o Visual Studio .NET ou Visual Studio 2005.
  2. No menu arquivo , aponte para novo e, em seguida, clique em Project .
  3. Clique em translation from VPE for Csharp Visual em Tipos de projeto e, em seguida, clique em Aplicativo de console em modelos . Nomeie o projeto ConConfig . Por padrão, Visual translation from VPE for Csharp cria uma classe que é chamada de programa.

    Observação No Visual Studio .NET 2003, clique em projetos do Visual translation from VPE for Csharp em Tipos de projeto e, em seguida, clique em Aplicativo de console em modelos . Nomeie o projeto ConConfig . Por padrão, Visual translation from VPE for Csharp cria uma classe que é denominada Class1.
  4. Verifique se a janela do Solution Explorer está visível. Se não estiver visível, pressione a combinação de teclas CTRL + ALT + L.
  5. No Solution Explorer, clique com o botão direito do mouse o nome do projeto, clique em Adicionar e, em seguida, clique em New Item .
  6. Na lista Add New Item , clique para selecionar Arquivo XML .
  7. Na caixa de texto nome , digite App.config e em seguida, clique em Adicionar .

    Observação No Visual Studio .NET 2003, clique em Abrir .
  8. Você pode usar um arquivo de configuração de aplicativo para coletar as configurações de aplicativo personalizado que salvar no formato de chave/valor. Você pode incluir <add> elementos o <appsettings> seção de um arquivo de configuração associados. Cada par chave/valor possui um <add> elemento. Um <add> elemento tem o seguinte formato:
    <add key="Key0" value="0" />
    adicionar um <appsettings> seção com <add> elementos para o arquivo de configuração entre o <configuration> and </configuration> marcas.

    Por exemplo, o seguinte arquivo de configuração inclui um <appsettings> seção especifica três pares chave/valor:
    <?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. No Solution Explorer, clique duas vezes em Program.cs para exibir a janela de código. Adicione as instruções a seguir a seu módulo de código.

    Observação Essas instruções devem aparecer antes de quaisquer outras instruções no arquivo.
    using System.Configuration;using System.Collections.Specialized;
  10. Adicione uma referência para System.Configuration.dll. Para fazer isso, execute as seguintes etapas:
    1. No menu Project , clique em Add Reference .
    2. Na caixa de diálogo Add Reference , clique na guia .NET .
    3. Localize e selecione o componente nome do System.Configuration.
    4. Clique em OK .
  11. Para manter o valor de uma chave de configuração de arquivo no <appsettings> seção do arquivo de configuração, declare uma variável seqüência de caracteres na seção principal da seguinte maneira:
     string  sAttr ;
  12. Para recuperar um valor para uma chave especificada do <appsettings> seção do arquivo de configuração, use o método Get da propriedade AppSettings da classe ConfigurationManager . A classe ConfigurationManager está no namespace System.Configuration . Quando o método AppSettings.Get recebe um parâmetro de entrada de seqüência de caracteres que contém uma chave, o aplicativo recupera o valor que está associado com a chave.

    O código a seguir recupera o valor para o atributo Key0 do arquivo de configuração associados. O código, em seguida, coloca esse valor na variável de seqüência de caracteres sAttr . Se uma chave não existe para esse valor, nada é armazenado no sAttr .
    sAttr = ConfigurationManager.AppSettings.Get("Key0");
  13. Para exibir o valor que o aplicativo recupera na janela do console, use console.WriteLine da seguinte maneira:
    Console.WriteLine("The value of Key0 is "+sAttr);
  14. Você pode usar uma referência à propriedade AppSettings para recuperar todos os pares chave/valor no <appsettings> seção. Quando você usa a propriedade AppSettings , o aplicativo retornará todos os pares chave/valor associado. Esses pares são armazenados em um tipo de coleção NameValueCollection . coleção NameValueCollection contém entradas de chave/valor para cada chave que o aplicativo recupera. A classe de coleção NameValueCollection é no espaço para nome System.Collections.Specialized .
    NameValueCollection sAll ;sAll = ConfigurationManager.AppSettings;
  15. Propriedade de coleção NameValueCollection AllKeys faz referência a uma matriz de seqüência de caracteres que tem uma entrada para cada chave que o aplicativo recupera. Use uma construção foreach para iterar a matriz AllKeys para acessar cada chave que o aplicativo recupera. Cada entrada de chave na AllKeys é um tipo de dados de seqüência de caracteres.

    Dentro de construção foreach , use console.WriteLine para exibir a chave e seu valor associado no console de janela. A chave atual que processa o aplicativo está em "s". Use esta opção como um índice no sAllNameValueCollection para obter seu valor associado.
       foreach (string s in sAll.AllKeys)      Console.WriteLine("Key: "+ s + " Value: " + sAll.Get(s));   Console.ReadLine();
back to the top

Concluir a listagem de código

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();       }    }}
Observação Esse código é direcionamento do .NET Framework 2.0. Se você estiver usando o .NET Framework 1.0 ou o .NET Framework 1.1, altere todas as ocorrências da classe ConfigurationManager para ConfigurationSettings .
back to the top

Concluir o arquivo de configuração listagem (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>
back to the top

Verificar se ele funciona

Pressione F5 para executar o código. A janela Console deve exibir os pares chave/valor da <appsettings> arquivo de seção de configuração associada da seguinte maneira:
The value of Key0: 0Key: Key0 Value:0Key: Key1 Value:1Key: Key2 Value:2		
back to the top

Solucionar problemas

  • O arquivo de configuração é salvo no formato XML. Certifique-se de que você execute todas as regras de sintaxe XML. Lembre-se que XML diferenciam maiúsculas de minúsculas. Se o XML não está bem formado, ou se um elemento é escrito incorretamente, você receber uma exceção System.Configuration.Configuration.

    Por exemplo, se você adicionar o atributo da chave de um <add> elemento com um maiúsculas "K" em vez de uma minúsculas "k", ou se o <appsettings> seção aparece como <appsettings> (com um "a"MAIÚSCULO em vez de um minúsculas "a"), você receber uma mensagem de erro.
  • O arquivo de configuração deve ser salvo na mesma pasta como seu aplicativo associado.
  • Você deve usar a seguinte sintaxe para o nome do arquivo de configuração:
    ApplicationName. ApplicationType .config
    onde ApplicationName é o nome do aplicativo, ApplicationType é o tipo de aplicativo (por exemplo, .exe) e .config é o sufixo necessário.
back to the top
Referências
Para obter mais informações, consulte o seguinte Microsoft Developer sites Network (MSDN (em INGLÊS) da Web: back to the top

Aviso: este artigo foi traduzido automaticamente

Propriedades

ID do Artigo: 815786 - Última Revisão: 07/16/2008 21:00:59 - Revisão: 3.1

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

  • kbmt kbsweptvs2008 kbcollections kbcollectionclass kbconfig kbnamespace kbhowtomaster kbprogramming KB815786 KbMtpt
Comentários