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

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
Para obter uma Microsoft Microsoft Visual C# .NET versão deste artigo, consulte 815786.
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.ConfigurationImports 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 NameValueCollectionsAll = 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 StringFor 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))NextConsole.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: 0Key: Key0 Value:0Key: Key1 Value:1Key: Key2 Value:2					

Concluir lista de código

Imports System.ConfigurationImports System.Collections.SpecializedModule 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 SubEnd 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:

Aviso: Este artigo foi traduzido automaticamente

Propriedades

ID do Artigo: 313405 - Última Revisão: 12/06/2006 23:18:25 - Revisão: 5.5

Microsoft Visual Basic 2005, Microsoft Visual Basic .NET 2003 Standard Edition, Microsoft Visual Basic .NET 2002 Standard Edition

  • kbmt kbvs2005swept kbvs2005applies kbconfig kbhowtomaster KB313405 KbMtpt
Comentários