Esquema de configurações do aplicativo

Artigo
08/25/2010

As configurações do aplicativo permitir que um aplicativo Windows Forms ou ASP.NET armazenar e recuperar as configurações de escopo do aplicativo e escopo do usuário. Uma "configuração", neste contexto, é qualquer informação que podem ser específicas do aplicativo ou específicos ao usuário corrente - tudo, de uma seqüência de caracteres de conexão do banco de dados ao dimensionar de janela padrão preferencial do usuário.

Por padrão, configurações do aplicativo em um aplicativo Windows Forms usa o LocalFileSettingsProvider, que usa o sistema de configuração do .NET para armazenar as configurações em um arquivo de configuração XML. Para obter mais informações sobre o uso de arquivos pelas configurações de aplicativo, consulte Arquitetura das Configurações do Aplicativo.

sistema autônomo configurações do aplicativo define sistema autônomo seguintes elementos sistema autônomo parte dos arquivos de configuração, ele usa.

Elemento	Descrição
<applicationSettings> Elemento	Contém todos os <setting> Rótulos específicas do aplicativo.
<userSettings> Elemento	Contém todos os <setting> Rótulos específicas para o usuário corrente.
<setting> Elemento	Define uma configuração. Filho de qualquer um dos <applicationSettings> ou <userSettings>.
<value> Elemento	Define um valor de configuração. Filhos de <setting>.

Elemento <applicationsettings>

Esse elemento contém todas as Rótulos <configuração>que são específicas para uma instância do aplicativo em um computador cliente. Ele define sem atributos.

Elemento <usersettings>

Esse elemento contém todas as Rótulos <configuração>que são específicas para o usuário que está usando o aplicativo. Ele define sem atributos.

Elemento <configuração>

Este elemento define uma configuração. Ele tem os seguintes atributos.

Elemento	Descrição
name	Obrigatório. A ID exclusiva da configuração. As configurações criadas pelo Visual Studio são salvas com o nome de ProjectName. Properties.Settings.
serializedAs	Obrigatório. O formato a ser usado para serializar o valor de texto. Os valores válido são: seqüência de caracteres. O valor é serializado sistema autônomo uma seqüência de caracteres usando um TypeConverter. XML. O valor é serializado usando a serialização de XML. binário. O valor é serializado sistema autônomo texto codificado binário usando a serialização binária. personalizado. O provedor de configurações tem conhecimento inerente dessa configuração e irá serializar e desserializá-lo. Usar a serialização binária ou personalizada, você deve definir sua própria classe de configurações e usar o SettingsSerializeAsAttribute Para especificar a serialização binária ou personalizada.

name

Obrigatório. A ID exclusiva da configuração. As configurações criadas pelo Visual Studio são salvas com o nome de ProjectName. Properties.Settings.

serializedAs

Obrigatório. O formato a ser usado para serializar o valor de texto. Os valores válido são:

seqüência de caracteres. O valor é serializado sistema autônomo uma seqüência de caracteres usando um TypeConverter.
XML. O valor é serializado usando a serialização de XML.
binário. O valor é serializado sistema autônomo texto codificado binário usando a serialização binária.
personalizado. O provedor de configurações tem conhecimento inerente dessa configuração e irá serializar e desserializá-lo.
Usar a serialização binária ou personalizada, você deve definir sua própria classe de configurações e usar o SettingsSerializeAsAttribute Para especificar a serialização binária ou personalizada.

Elemento <valor>

Esse elemento contém o valor de uma configuração.

Exemplo

O exemplo de código a seguir mostra um arquivo de configurações de aplicativo que define duas configurações de escopo do aplicativo e duas configurações de escopo do usuário.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <configSections>
        <sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
        </sectionGroup>
        <sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" />
        </sectionGroup>
    </configSections>
    <applicationSettings>
        <WindowsApplication1.Properties.Settings>
            <setting name="Cursor" serializeAs="String">
                <value>Default</value>
            </setting>
            <setting name="DoubleBuffering" serializeAs="String">
                <value>False</value>
            </setting>
        </WindowsApplication1.Properties.Settings>
    </applicationSettings>
    <userSettings>
        <WindowsApplication1.Properties.Settings>
            <setting name="FormTitle" serializeAs="String">
                <value>Form1</value>
            </setting>
            <setting name="FormSize" serializeAs="String">
                <value>595, 536</value>
            </setting>
        </WindowsApplication1.Properties.Settings>
    </userSettings>
</configuration>

Consulte também

Conceitos

Visão Geral Sobre Configurações do Aplicativo

Arquitetura das Configurações do Aplicativo

Partilhar via