SectionDefinition Clase

Definición

Espacio de nombres:

Microsoft.Web.Administration

Ensamblado:

Microsoft.Web.Administration.dll

Define una sección de configuración.

public ref class SectionDefinition sealed

public sealed class SectionDefinition

type SectionDefinition = class

Public NotInheritable Class SectionDefinition

Herencia

Object

SectionDefinition

Ejemplos

En el ejemplo siguiente se muestra cómo definir una sección de configuración y definir valores para esa sección.

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);
            }
        }

    }
}

Comentarios

Al declarar una sección de configuración, se define un nuevo elemento para el archivo de configuración. El nuevo elemento contiene la configuración que lee un controlador de sección de configuración. Los atributos y los elementos secundarios de una sección que defina dependen del manipulador de la sección que use para leer la configuración.

El elemento siguiente <configuration> contiene un ejemplo del <section> elemento que representa la SectionDefinition clase .

<configuration>

<configSections>

<section name="sampleSection"

type="System.Configuration.SingleTagSectionHandler"

allowLocation="false"/>

</configSections>

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

setting3="third value" />

</configuration>

Propiedades

AllowDefinition	Obtiene o establece un valor que indica las ubicaciones válidas de la ruta de acceso de configuración de la sección de configuración.
AllowLocation	Obtiene o establece un valor que indica si la sección de configuración permite el atributo location.
Name	Obtiene el nombre de la definición de sección de configuración actual.
OverrideModeDefault	Obtiene o establece el comportamiento de invalidación predeterminado para la sección de configuración actual.
RequirePermission	Define una sección de configuración.
Type	Obtiene o establece el nombre de tipo de una clase que implementa la sección de configuración y puede interpretar el XML persistente.