SectionDefinition Classe

Definizione

Spazio dei nomi:

Microsoft.Web.Administration

Assembly:

Microsoft.Web.Administration.dll

Definisce una sezione di configurazione.

public ref class SectionDefinition sealed

public sealed class SectionDefinition

type SectionDefinition = class

Public NotInheritable Class SectionDefinition

Ereditarietà

Object

SectionDefinition

Esempio

Nell'esempio seguente viene illustrato come definire una sezione di configurazione e definire le impostazioni per tale sezione.

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

    }
}

Commenti

La dichiarazione di una sezione di configurazione definisce un nuovo elemento per il file di configurazione. Il nuovo elemento contiene le impostazioni lette da un gestore della sezione di configurazione. Gli attributi e gli elementi figlio di una sezione definiti dipendono dal gestore di sezioni usato per leggere le impostazioni.

L'elemento seguente <configuration> contiene un esempio dell'elemento <section> rappresentato dalla SectionDefinition classe .

<configuration>

<configSections>

<section name="sampleSection"

type="System.Configuration.SingleTagSectionHandler"

allowLocation="false"/>

</configSections>

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

setting3="third value" />

</configuration>

Proprietà

AllowDefinition	Ottiene o imposta un valore che indica i percorsi di percorso di configurazione validi per la sezione di configurazione.
AllowLocation	Ottiene o imposta un valore che indica se la sezione di configurazione consente l'attributo location.
Name	Ottiene il nome della definizione della sezione di configurazione corrente.
OverrideModeDefault	Ottiene o imposta il comportamento di override predefinito per la sezione di configurazione corrente.
RequirePermission	Definisce una sezione di configurazione.
Type	Ottiene o imposta il nome del tipo di una classe che implementa la sezione di configurazione e può interpretare il codice XML persistente.