Classe SectionInformation

Specifica le impostazioni di override della modalità e del blocco del controllo per una sezione di configurazione.

Sintassi

class SectionInformation : EmbeddedObject  

Metodi

Questa classe non contiene metodi.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla SectionInformation classe .

Nome	Descrizione
EffectiveOverrideMode	Valore di sola string lettura che specifica se la sezione di configurazione corrente può eseguire in modo efficace l'override delle impostazioni ereditate. I valori possibili sono elencati più avanti nella sezione Osservazioni. Per determinare il valore di EffectiveOverrideMode, IIS attraversa la gerarchia di ereditarietà delle sezioni di configurazione dalla sezione corrente. Esamina successivamente la OverrideMode proprietà di ogni sezione padre fino a raggiungere l'attributo overrideModeDefault nella definizione dello schema di sezione. IIS calcola l'oggetto EffectiveOverrideMode combinando logicamente i valori che rileva e considerando la classificazione gerarchica. Nota: overrideModeDefault è un attributo facoltativo che contiene lo stato di blocco predefinito di una sezione di configurazione. L'attributo overrideModeDefault per ogni sezione di configurazione si trova nella definizione <configSections> di sezione corrispondente in nel file ApplicationHost.config. Se overrideModeDefault manca, il valore è "Consenti". Se si specifica "Consenti", i file Web.config di livello inferiore possono eseguire l'override delle impostazioni per la sezione; se viene specificato "Deny", non è possibile. Il valore predefinito per la overrideModeDefault maggior parte delle sezioni del server Web IIS è "Nega". L'impostazione predefinita per la maggior parte delle sezioni ASP.NET e .NET Framework è "Consenti", perché queste sezioni contengono impostazioni a livello di applicazione. L'attributo overrideModeDefault non ha proprietà corrispondenti in WMI. Se si dispone delle autorizzazioni appropriate, è possibile modificare direttamente il file ApplicationHost.config o accedervi a livello di codice usando le API di analisi XML o di accesso ai file.
IsLocked	Valore boolean di sola lettura. true se non è possibile modificare la sezione di configurazione corrente e i relativi elementi figlio; in caso contrario, false.
LockItem	Valore di lettura/scrittura boolean . true se la sezione di configurazione corrente e i relativi elementi figlio sono bloccati; in caso contrario, false. Il valore predefinito è false. Nota: anche se il valore predefinito è false, questa proprietà restituirà null quando viene inizialmente letta. Se si imposta in modo esplicito questo valore iniziale su false, la proprietà restituirà nullcomunque . Tuttavia, se si imposta il valore iniziale su true, la proprietà restituirà true; se quindi si imposta il valore su false, la proprietà restituirà falsein modo esplicito . Questo comportamento è dovuto a una limitazione nel provider WMI.
OverrideMode	Valore di lettura/scrittura string che specifica se i file di configurazione di livello inferiore possono eseguire l'override delle impostazioni nella sezione di configurazione corrente. I valori possibili sono elencati più avanti nella sezione Osservazioni.

Sottoclassi

Questa classe non contiene sottoclassi.

Osservazioni:

Le istanze di questa classe sono contenute nella SectionInformation proprietà della classe ConfigurationSection . Tutte le classi di sezioni di configurazione ereditano la SectionInformation classe come una delle relative proprietà.

Nella tabella seguente sono elencati i valori possibili per la EffectiveOverrideMode proprietà .

Parola chiave	Descrizione
Allow	I file di configurazione di livello inferiore possono eseguire l'override delle impostazioni nella sezione di configurazione corrente.
Deny	I file di configurazione di livello inferiore non possono eseguire l'override delle impostazioni nella sezione di configurazione corrente.

Nella tabella seguente sono elencati i valori possibili per la OverrideMode proprietà . Il valore predefinito è "Inherit".

Parola chiave	Descrizione
Inherit	I file di configurazione di livello inferiore possono o non possono eseguire l'override delle impostazioni nella sezione di configurazione corrente, a seconda della combinazione di OverrideMode valori che ereditano.
Allow	I file di configurazione di livello inferiore possono eseguire l'override delle impostazioni nella sezione di configurazione corrente.
Deny	I file di configurazione di livello inferiore non possono eseguire l'override delle impostazioni nella sezione di configurazione corrente.

Nota

La EffectiveOverrideMode proprietà è utile per determinare la modalità di override effettiva per una sezione di configurazione quando la OverrideMode proprietà è impostata su "Inherit".

Esempio

Nell'esempio seguente vengono recuperate le SectionInformation proprietà per tutte le sezioni di configurazione.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Retrieve configuration sections.  
Set oConfigSections = oWebAdmin.ExecQuery( _  
    "SELECT * FROM ConfigurationSection")  
  
' Loop through the configuration sections.  
For Each oConfigSection In oConfigSections  
    iCounter = iCounter + 1  
  
    ' Display the name of each configuration section and its location.  
    WScript.Echo "[" & iCounter & "] " & oConfigSection.Path_.Class  
    WScript.Echo "Location: " & oConfigSection.Location  
  
    ' Display the SectionInformation property values.  
    Set oConfigSectionInfo = oConfigSection.SectionInformation  
    WScript.Echo "Effective Override Mode: " & _  
        oConfigSectionInfo.EffectiveOverrideMode  
    WScript.Echo "Is Locked: " & oConfigSectionInfo.IsLocked  
    WScript.Echo "Is Present: " & oConfigSectionInfo.IsPresent          
    WScript.Echo "Lock Item: " & oConfigSectionInfo.LockItem              
    WScript.Echo "Override Mode: " & oConfigSectionInfo.OverrideMode  
    WScript.Echo "------------------------------------------"  
Next  
  

Gerarchia di ereditarietà

EmbeddedObject

SectionInformation

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
File MOF	WebAdministration.mof

Vedi anche

Classe ConfigurationSection
Classe EmbeddedObject