Esquema de configurações do aplicativo

Artigo
08/01/2011

Configurações de aplicativo permitem a um Windows Forms ou ASP.NET para armazenar e recuperar o escopo do aplicativo e configurações de escopo do usuário. Uma "configuração", neste contexto, é qualquer informação que pode ser específica do aplicativo ou específicos ao usuário atual - tudo a partir de uma seqüência de conexão de banco de dados ao tamanho de janela padrão preferencial do usuário.

Por padrão, as configurações do aplicativo em um aplicativo Windows Forms usa a LocalFileSettingsProvider, que usa o.Sistema de configuração de rede para armazenar 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.

Configurações do aplicativo define os elementos a seguintes como parte dos arquivos de configuração, ele usa.

Elemento	Descrição
<applicationSettings>Elemento	Contém todos os <setting> marcas específicas ao aplicativo.
<userSettings>Elemento	Contém todos os <setting> marcas específicas para o usuário atual.
<setting>Elemento	Define uma configuração. O filho de um <applicationSettings> ou <userSettings>.
<value>Elemento	Define o valor da configuração. Filho do <setting>.

<applicationSettings> Elemento

Esse elemento contém todos os <setting>. marcas de formatação que são específicas para uma instância do aplicativo em um computador cliente. Ele define sem atributos.

<userSettings> Elemento

Esse elemento contém todos os <setting>. marcas de formatação que são específicas para o usuário que está usando o aplicativo. Ele define sem atributos.

<setting> Elemento

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

Elemento	Descrição
name	Obrigatório. A identificação exclusiva da configuração. Criado por meio de Visual Studio de configurações são salvas com o nome ProjectName.Properties. Settings.
serializedAs	Obrigatório. O formato a ser usado para serializar o valor de texto. Os valores válidos são: string. O valor é serializado como uma seqüência de caracteres usando um TypeConverter. xml. O valor é serializado usando a serialização de XML. binário. O valor é serializado como binários de texto codificado usando a serialização binária. personalizado. O provedor de configurações tem conhecimento inerente dessa configuração e serializar e desserializar a ele. Para 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 personalizado.

name

Obrigatório. A identificação exclusiva da configuração. Criado por meio de Visual Studio de configurações são salvas com o nome ProjectName.Properties. Settings.

serializedAs

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

string. O valor é serializado como uma seqüência de caracteres usando um TypeConverter.
xml. O valor é serializado usando a serialização de XML.
binário. O valor é serializado como binários de texto codificado usando a serialização binária.
personalizado. O provedor de configurações tem conhecimento inerente dessa configuração e serializar e desserializar a ele.
Para 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 personalizado.

<value> Elemento

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

Exemplo

O exemplo de código a seguir mostra um arquivo de configurações do 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

Compartilhar via