Como armazenar e recuperar informações personalizadas de um arquivo de configuração de aplicativo usando o Visual Basic .NET ou Visual Basic 2005

Traduções deste artigo Traduções deste artigo
ID do artigo: 313405 - Exibir os produtos aos quais esse artigo se aplica.
Para obter uma Microsoft Microsoft Visual translation from VPE for Csharp .NET versão deste artigo, consulte 815786.
Expandir tudo | Recolher tudo

Neste artigo

Sumário

Este artigo demonstra 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 é um útil quando você precisa definir dados que está associados a um aplicativo.


Requisitos

A lista a seguir descreve o hardware recomendado, software, infra-estrutura de rede e service packs que você precisa:
  • Microsoft Windows 2000, Microsoft Windows XP ou Microsoft Windows Server 2003
  • Microsoft Visual Studio .NET (2002) ou Microsoft Visual Studio .NET (2003) ou Microsoft Visual Studio 2005
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

Criar aplicativo de console que leituras conteúdo do 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. Crie um novo projeto Console Application chamado ConConfig Visual Basic.NET de Visual Basic 2005. Visual Basic .NET ou Visual Basic 2005 cria um módulo chamado Module1 por padrão.
  3. Clique com o botão direito do ConConfig Project pasta, aponte para Add e, em seguida, clique em Add New Item .

    Observação No Visual Studio 2005, clique com o botão direito do ConConfig Project pasta, aponte para Add e em seguida, clique em New Item .
  4. Na caixa de diálogo Add New Item , selecione o modelo Application Configuration File , clique em Abrir e adicione o arquivo app.config para o projeto.

    Observação O Visual Studio .NET ou Visual Studio 2005 IDE copia App.config para a pasta onde o arquivo executável é compilado e renomeia ele em <ApplicationName>. <Application Type>.config formato.
  5. 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="theKey" value="theValue" />
    						
    adicionar um <appsettings> seção com <add> elementos para o arquivo de configuração entre as marcas <configuration> e </configuration>. 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>
    					
  6. No Solution Explorer, clique duas vezes em Module1.vb para exibir a janela de código Module1. 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.
    Imports System.Configuration
    Imports System.Collections.Specialized
    					
  7. No procedimento Sub Main , uma variável de seqüência de caracteres para o valor de uma chave de configuração de arquivo no <appsettings> de dimensão seção do arquivo de configuração:
    Dim sAttr As String
    					
  8. Para recuperar um valor para uma chave especificada do <appsettings> seção do arquivo de configuração, use o método AppSettings da classe ConfigurationSettings . A classe ConfigurationSettings está no namespace System.Configuration . Quando o método AppSettings 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, Nothing é armazenada no sAttr .
    sAttr = ConfigurationSettings. AppSettings("Key0")
    					
  9. Para exibir o valor que o aplicativo recupera na janela do console, use console.WriteLine :
    Console.WriteLine("The value of Key0: " & sAttr)
    					
  10. Você pode usar uma referência à propriedade AppSettings para recuperar todos os pares chave/valor no <appsettings> seção. Se você não especificar os parâmetros 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 , que contém entradas para cada chave que o aplicativo recupera a chave/valor. A classe de coleção NameValueCollection é no espaço para nome System.Collections.Specialized .
    Dim sAll As NameValueCollection
    sAll = ConfigurationSettings.AppSettings()
    					
  11. 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 For Next para percorrer a matriz AllKeys para acessar cada chave que o aplicativo recupera. Cada chave entrada AllKeys é uma seqüência de caracteres dados tipo.
    Dim s As String
    For Each s In sAll.AllKeys
    					
  12. Dentro de construção for each , 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 sAll NameValueCollection para obter seu valor associado.

    Por exemplo, se o aplicativo processa a chave Key0 , sAll("Key0") recupera o valor associado. A instrução Console.readline pausa o console. Você pode pressionar ENTER para finalizar o aplicativo.
        Console.WriteLine("Key: " & s & " Value: " & sAll(s))
    Next
    Console.Readline
    					

Verificar se ele funciona

Pressione a tecla 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: 0
Key: Key0 Value:0
Key: Key1 Value:1
Key: Key2 Value:2
					

Concluir a listagem de código

Imports System.Configuration
Imports System.Collections.Specialized

Module Module1

    Sub Main()
        Dim sAttr As String

        sAttr = ConfigurationSettings.AppSettings("Key0")
        Console.WriteLine("The value of Key0: " & sAttr)
        
        Dim sAll As NameValueCollection
        sAll = ConfigurationSettings.AppSettings()

        Dim s As String
        For Each s In sAll.AllKeys
            Console.WriteLine("Key: " & s & " Value: " & sAll(s))
        Next
		  Console.ReadLine()
    End Sub

End Module
				

Concluir o arquivo de configuração listagem (ConConfig.exe.config)

<configuration>
	<appSettings>
		<add key="Key0" value="0"/>
		<add key="Key1" value="1"/>
		<add key="Key2" value="2"/>
	</appSettings>
</configuration>
				

Solução de 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 é diferencia 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 incluído no projeto.
  • Você deve usar a seguinte sintaxe para o nome do arquivo de configuração quando o arquivo é criado fora do ambiente Visual Studio e ele deve residir na mesma pasta do seu aplicativo associado:
    ApplicationName. ApplicationType .config
    onde ApplicationName é o nome do aplicativo, ApplicationType é o tipo de aplicativo (por exemplo, exe) e .config é o sufixo necessário.

Referências

Para obter mais informações, visite os seguintes sites da MSDN:
Propriedade ConfigurationSettings.AppSettings
http://msdn2.microsoft.com/en-us/library/system.configuration.configurationsettings.appsettings(vs.71).aspx
System.Configuration Namespace
http://msdn2.microsoft.com/en-us/library/system.configuration(vs.71).aspx

Propriedades

ID do artigo: 313405 - Última revisão: quarta-feira, 6 de dezembro de 2006 - Revisão: 5.5
A informação contida neste artigo aplica-se a:
  • Microsoft Visual Basic 2005
  • Microsoft Visual Basic .NET 2003 Standard Edition
  • Microsoft Visual Basic .NET 2002 Standard Edition
Palavras-chave: 
kbmt kbvs2005swept kbvs2005applies kbconfig kbhowtomaster KB313405 KbMtpt
Tradução automática
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: 313405

Submeter comentários

 

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