Como armazenar e obter informações personalizadas a partir de um ficheiro de configuração de aplicação utilizando o Visual Basic .NET ou Visual Basic 2005

Traduções de Artigos Traduções de Artigos
Artigo: 313405 - Ver produtos para os quais este artigo se aplica.
Para obter uma Microsoft Microsoft Visual C# .NET versão deste artigo, consulte 815786.
Expandir tudo | Reduzir tudo

Nesta página

Sumário

Este artigo demonstra como armazenar informações personalizadas num ficheiro de configuração (.config) que pode obter posteriormente durante a execução, a aplicação associada. Isto é uma útil quando necessita de definir os dados que está associados uma aplicação.


Requisitos

A lista seguinte descreve o hardware recomendado, software, infra-estrutura de rede e service packs que necessita:
  • Microsoft Windows 2000, Microsoft Windows XP ou Microsoft Windows Server 2003
  • Microsoft Visual Studio .NET (2002), Microsoft Visual Studio .NET (2003) ou Microsoft Visual Studio 2005
Este artigo pressupõe que está familiarizado com os seguintes tópicos:
  • Extensible Markup Language (XML)
  • Ficheiros de configuração do .NET

Criar aplicação de consola que lê o conteúdo do ficheiro de configuração

É possível armazenar definições da aplicação no ficheiro de configuração que está associado a aplicação. Ficheiros de configuração são guardados no XML formato. System.Configuration e espaços de nomes System.Collections.Specialized no Microsoft .NET Framework incluem as classes necessárias para obter informações de um ficheiro de configuração de aplicação do .NET durante a execução.

Para criar uma aplicação de consola que lê o conteúdo de um ficheiro de configuração associados ao durante a execução, siga estes passos:
  1. Inicie o Visual Studio .NET ou Visual Studio 2005.
  2. Crie um projecto aplicação de consola novo denominado ConConfig no Visual Basic .NET ou Visual Basic 2005. Visual Basic .NET ou Visual Basic 2005 cria um módulo denominado Módulo1 por predefinição.
  3. Clique com o botão direito do rato a ConConfig Project pasta, aponte para Adicionar e, em seguida, clique em Adicionar novo item .

    Nota No Visual Studio 2005, clique com o botão direito do rato a ConConfig Project pasta, aponte para Adicionar e, em seguida, clique em Novo Item .
  4. Na caixa de diálogo Adicionar novo item , seleccione o modelo de Ficheiro de configuração da aplicação , clique em Abrir e, em seguida, adicionar o ficheiro App.config ao projecto.

    Nota O Visual Studio .NET ou Visual Studio 2005 IDE copia App.Config para a pasta onde o ficheiro executável está compilado e muda o nome de <ApplicationName>. <Application Type>.config formato.
  5. Pode utilizar um ficheiro de configuração da aplicação para recolher as definições de aplicação personalizada que guardar no formato de chave/valor. Pode incluir <add> elementos a <appsettings> secção de um ficheiro de configuração associados. Cada par de chave/valor tiver <add> elemento. Um <add> elemento tem o seguinte formato:
    <add key="theKey" value="theValue" />
    						
    adicionar um <appsettings> secção com <add> elementos para o ficheiro de configuração entre as tags <configuration> e </configuration>. Por exemplo, o ficheiro de configuração que se segue inclui um<appsettings> secção especifica três chave/valor pares:
    <?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, faça duplo clique em Module1.vb para visualizar a janela de código Módulo1. Adicione as declarações seguintes para o módulo de código:

    Nota Estas instruções têm de aparecer antes de quaisquer outras instruções no ficheiro
    Imports System.Configuration
    Imports System.Collections.Specialized
    					
  7. No procedimento Sub Main , uma cadeia variável para conter o valor de uma chave de ficheiro de configuração no <appsettings> da dimensão secção do ficheiro de configuração:
    Dim sAttr As String
    					
  8. Para obter um valor para uma chave especificada a partir de <appsettings> secção do ficheiro de configuração, utilize o método AppSettings da classe ConfigurationSettings . A classe ConfigurationSettings é no espaço de nomes System.Configuration . Quando o método de AppSettings recebe um parâmetro de entrada de cadeia que contém uma chave, a aplicação obtém o valor associado à chave.

    O código seguinte obtém o valor para o atributo Key0 do ficheiro de configuração associados. O código, em seguida, coloca este valor na variável de cadeia, sAttr . Se não existir uma chave para este valor, nada é armazenado no sAttr .
    sAttr = ConfigurationSettings. AppSettings("Key0")
    					
  9. Para apresentar o valor que a aplicação obtém na janela da consola, utilize Console.WriteLine :
    Console.WriteLine("The value of Key0: " & sAttr)
    					
  10. Pode utilizar uma referência à propriedade AppSettings para obter todos os pares de chave/valor de <appsettings> secção. Se não especificar quaisquer parâmetros quando utiliza a propriedade AppSettings , a aplicação devolve todos os pares chave/valor associado. Estes pares são armazenados num tipo de NameValueCollection , que contém entradas de chave/valor para cada chave que a aplicação obtém. A classe NameValueCollection é no espaço de nomes System.Collections.Specialized .
    Dim sAll As NameValueCollection
    sAll = ConfigurationSettings.AppSettings()
    					
  11. A propriedade ' AllKeys da NameValueCollection faz referência uma matriz de cadeia que tem uma entrada para cada chave que a aplicação obtém. Utilize uma construção Para o seguinte para iterar através de matriz AllKeys para aceder a cada chave que a aplicação obtém. Cada chave entrada na AllKeys é uma cadeia de dados tipo.
    Dim s As String
    For Each s In sAll.AllKeys
    					
  12. Dentro de construção for each , utilizar Console.WriteLine para apresentar a chave e respectivo valor associado na consola de janela. A chave actual que processa a aplicação é em "s". Utilize este como um índice numa sAll NameValueCollection para obter o valor associado.

    Por exemplo, se a aplicação processa a chave Key0 , sAll("Key0") obtém o valor associado. A instrução Console.Readline interrompe a consola. Pode premir ENTER para terminar a aplicação.
        Console.WriteLine("Key: " & s & " Value: " & sAll(s))
    Next
    Console.Readline
    					

Verificar se funciona

Prima a tecla F5 para executar o código. A janela da consola deve apresentar os pares de chave/valor do <appsettings> secção de configuração associados ao ficheiro da seguinte forma:
The value of Key0: 0
Key: Key0 Value:0
Key: Key1 Value:1
Key: Key2 Value:2
					

Concluir lista 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 ficheiro de configuração lista (ConConfig.exe.config)

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

Resolução de problemas

  • O ficheiro de configuração é guardado no formato XML. Certifique-se de que siga todas as regras de sintaxe XML. Lembre-se de que XML é sensível a maiúsculas / minúsculas. Se o XML não está bem formado, ou se um elemento está mal escrito, receberá uma excepção System.Configuration.Configuration.

    Por exemplo, se adicionar o atributo de um <add> chave elemento com um maiúsculas "K" em vez de uma minúsculas "k", ou se o <appsettings> secção aparece como <appsettings> (com uma maiúsculas "A" em vez de uma minúscula "a"), recebe uma mensagem de erro.
  • O ficheiro de configuração deve estar incluído no projecto.
  • Tem de utilizar a seguinte sintaxe para o nome de ficheiro de configuração quando é criado o ficheiro fora do ambiente do Visual Studio e tem de residir na mesma pasta que a aplicação associada:
    ApplicationName. ApplicationType .config
    onde ApplicationName é o nome da aplicação, ApplicationType é o tipo de aplicação (por exemplo, exe) e .config é o sufixo necessário.

Referências

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

Propriedades

Artigo: 313405 - Última revisão: 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 revisto ou traduzido por humanos. A Microsoft tem artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais. O objectivo é simples: oferecer em Português a totalidade dos artigos existentes na base de dados do suporte. Sabemos no entanto que a tradução automática não é sempre perfeita. Esta pode conter erros de vocabulário, sintaxe ou gramática? erros semelhantes aos que um estrangeiro realiza ao falar em Português. A Microsoft não é responsável por incoerências, erros ou estragos realizados na sequência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza actualizações frequentes 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