SectionDefinition Classe

Definição

Namespace:

Microsoft.Web.Administration

Assembly:

Microsoft.Web.Administration.dll

Define uma seção de configuração.

public ref class SectionDefinition sealed

public sealed class SectionDefinition

type SectionDefinition = class

Public NotInheritable Class SectionDefinition

Herança

Object

SectionDefinition

Exemplos

O exemplo a seguir mostra como definir uma seção de configuração e definir as configurações para essa seção.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Web.Administration;
using Microsoft.Web.Management;

namespace AdministrationSnippets
{
    public class AdministrationSectionDefinition
    {
        // List all configuration sections in applicationHost.config
        public void ShowAllSections()
        {
            ServerManager manager = new ServerManager();
            SectionGroup rootGroup = 
                manager.GetApplicationHostConfiguration().RootSectionGroup;
            ShowGroup(rootGroup, -1);

        }

        private void ShowGroup(SectionGroup group, int indentLevel)
        {
            Console.Write("".PadLeft(++indentLevel, ' '));
            string grpName = String.IsNullOrEmpty(group.Name) ? "{root}" : group.Name;
            Console.WriteLine("+ Section Group: {0}; Sub-groups: {1}; Sections: {2}",
                grpName, group.SectionGroups.Count, group.Sections.Count);

            foreach (SectionGroup grp in group.SectionGroups)
            {
                ShowGroup(grp, indentLevel);
            }

            string path = String.Concat(group.Name, "/");

            foreach (SectionDefinition def in group.Sections)
            {
                Console.Write("".PadLeft(indentLevel, ' '));
                Console.WriteLine("|_Name:                {0}", String.Concat(path,def.Name));
                Console.Write("".PadLeft(indentLevel, ' '));
                Console.WriteLine("|_AllowDefinition:     {0}", def.AllowDefinition);
                Console.Write("".PadLeft(indentLevel, ' '));
                Console.WriteLine("|_AllowLocation:       {0}", def.AllowLocation);
                Console.Write("".PadLeft(indentLevel, ' '));
                Console.WriteLine("|_OverrideModeDefault: {0}", def.OverrideModeDefault);
                Console.Write("".PadLeft(indentLevel, ' '));
                Console.WriteLine("|_Type:                {0}\r\n", 
                    String.IsNullOrEmpty(def.Type) ? "null" : def.Type);
            }
        }

    }
}

Comentários

Declarar uma seção de configuração define um novo elemento para o arquivo de configuração. O novo elemento contém as configurações que um manipulador de seção de configuração lê. Os atributos e os elementos filho de uma seção que você define dependem do manipulador de seção que você usa para ler suas configurações.

O elemento a seguir <configuration> contém um exemplo do <section> elemento que a SectionDefinition classe representa.

<configuration>

<configSections>

<section name="sampleSection"

type="System.Configuration.SingleTagSectionHandler"

allowLocation="false"/>

</configSections>

<sampleSection setting1="Value1" setting2="value two"

setting3="third value" />

</configuration>

Propriedades

AllowDefinition	Obtém ou define um valor que indica locais de caminho de configuração válidos para a seção de configuração.
AllowLocation	Obtém ou define um valor que indica se a seção de configuração permite o atributo location.
Name	Obtém o nome da definição da seção de configuração atual.
OverrideModeDefault	Obtém ou define o comportamento de substituição padrão para a seção de configuração atual.
RequirePermission	Define uma seção de configuração.
Type	Obtém ou define o nome do tipo de uma classe que implementa a seção de configuração e pode interpretar o XML persistente.