Classe SectionInformation

Articolo
07/19/2023

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à `null`comunque . Tuttavia, se si imposta il valore iniziale su `true`, la proprietà restituirà `true`; se quindi si imposta il valore su `false`, la proprietà restituirà `false`in 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

Condividi tramite