Condividi tramite

App Defaults <applicationDefaults>

  • Articolo

Panoramica

L'elemento <applicationDefaults> dell'elemento <site> specifica le impostazioni predefinite dell'applicazione per tutte le applicazioni nel sito padre.

Nota

Se lo stesso attributo o elemento figlio è configurato sia <applicationDefaults> nella sezione che nella <application> sezione per un'applicazione specifica, la configurazione nella sezione viene usata per tale <application> applicazione.

Compatibilità

Versione Note
IIS 10.0 L'elemento <applicationDefaults> non è stato modificato in IIS 10.0.
IIS 8,5 L'elemento <applicationDefaults> non è stato modificato in IIS 8.5.
IIS 8,0 L'attributo preLoadEnabled è stato aggiunto in IIS 8.0.
IIS 7,5 L'elemento <applicationDefaults> è stato aggiornato per includere gli serviceAutoStartEnabled attributi e serviceAutoStartProvider .
IIS 7.0 L'elemento <applicationDefaults><site> della raccolta è stato introdotto in IIS 7.0.
IIS 6.0 L'elemento <applicationDefaults> è analogo all'impostazione delle opzioni dell'applicazione a livello di sito nella metabase IIS 6.0.

Installazione

L'elemento <applicationDefaults> dell'elemento è incluso nell'installazione <site> predefinita di IIS 7 e versioni successive.

Procedure

Come configurare le impostazioni predefinite dell'applicazione per un sito

  1. Aprire Gestione Internet Information Services (IIS):

    • Se si usa Windows Server 2012 o Windows Server 2012 R2:

      • Sulla barra delle applicazioni fare clic su Server Manager, scegliere Strumenti, quindi fare clic su Gestione Internet Information Services (IIS).

    • Se si usa Windows 8 o Windows 8.1:

      • Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
      • Fare clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).

    • Se si usa Windows Server 2008 o Windows Server 2008 R2:

      • Sulla barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione, quindi fare clic su Gestione Internet Information Services (IIS).

    • Se si usa Windows Vista o Windows 7:

      • Sulla barra delle applicazioni fare clic su Start e quindi su Pannello di controllo.
      • Fare doppio clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).

  2. Nel riquadro Connessioni espandere il nome del server, espandere il nodo Siti , quindi fare clic sul nome del sito.

  3. Nel riquadro Home del sito fare clic su Visualizza applicazioni nel riquadro Azioni .
    Screenshot della schermata Home del sito Web predefinito, che mostra le opzioni dot NET Compilation, dot NET Globalization e dot NET Profile.

  4. Nel riquadro Applicazione del sito fare clic su Imposta impostazioni predefinite applicazione nel riquadro Azioni .
    Screenshot del riquadro Applicazioni, che mostra i campi Percorso virtuale e Percorso fisico.

  5. Nella finestra di dialogo Impostazioni predefinite applicazione specificare le impostazioni dell'applicazione predefinite per il sito e quindi fare clic su OK.
    Screenshot delle sezioni Generale e Comportamento.

Configurazione

Attributi

Attributo Descrizione
applicationPool Attributo stringa facoltativo.

Specifica il pool di applicazioni predefinito a cui vengono assegnate tutte le applicazioni nel sito padre.
enabledProtocols Attributo stringa facoltativo.

Specifica i protocolli da usare per comunicare con tutte le applicazioni nel sito padre.
path Attributo stringa facoltativo.

Specifica il percorso virtuale predefinito di tutte le applicazioni nel sito padre.
preLoadEnabled Attributo booleano facoltativo.

Specifica che IIS simula una richiesta utente alla pagina predefinita di un'applicazione o di una directory virtuale in modo che venga inizializzata. In effetti IIS avvia l'applicazione all'avvio del pool di applicazioni senza aver ricevuto una richiesta. Ciò aumenta le prestazioni eseguendo attività di inizializzazione, ad esempio il caricamento di moduli gestiti e la compilazione di codice gestito. Nei log IIS non viene generato alcun log. L'impostazione startMode del pool di applicazioni deve essere impostata su AlwaysRunning.

Il valore predefinito è False.
serviceAutoStartEnabled Attributo booleano facoltativo.

true se l'avvio automatico è abilitato per questa applicazione; in caso contrario, false.

Il valore predefinito è false.
serviceAutoStartProvider Attributo stringa facoltativo.

Specifica il nome del provider di avvio automatico che verrà usato dal servizio attivazione processo Windows (WAS) se serviceAutoStartEnabled è impostato su true.

Non è previsto alcun valore predefinito.

Elementi figlio

Nessuno.

Esempio di configurazione

L'esempio di configurazione seguente imposta il pool di applicazioni predefinito per il sito Web predefinito su "DefaultAppPool".

<sites>
   <site name="Default Web Site" id="1" serverAutoStart="true">
      <application path="/" applicationPool="Classic .NET AppPool">
         <virtualDirectory path="/" physicalPath="%SystemDrive%\inetpub\wwwroot" />
      </application>
      <bindings>
         <binding protocol="http" bindingInformation="*:80:" />
      </bindings>
      <applicationDefaults applicationPool="DefaultAppPool" />
   </site>
</sites>

Codice di esempio

Gli esempi di codice seguenti impostano il pool di applicazioni predefinito per il sito Web predefinito su "DefaultAppPool".

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites "/[name='Default Web Site'].applicationDefaults.applicationPool:DefaultAppPool" /commit:apphost

Nota

È necessario assicurarsi di impostare il parametro commit su apphost quando si usa AppCmd.exe per configurare queste impostazioni. In questo modo le impostazioni di configurazione vengono confermate nella sezione relativa al percorso appropriato nel file ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");

         ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();
         ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"Default Web Site");
         if (siteElement == null) throw new InvalidOperationException("Element not found!");

         ConfigurationElement applicationDefaultsElement = siteElement.GetChildElement("applicationDefaults");
         applicationDefaultsElement["applicationPool"] = @"DefaultAppPool";

         serverManager.CommitChanges();
      }
   }

   private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
   {
      foreach (ConfigurationElement element in collection)
      {
         if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
         {
            bool matches = true;
            for (int i = 0; i < keyValues.Length; i += 2)
            {
               object o = element.GetAttributeValue(keyValues[i]);
               string value = null;
               if (o != null)
               {
                  value = o.ToString();
               }
               if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
               {
                  matches = false;
                  break;
               }
            }
            if (matches)
            {
               return element;
            }
         }
      }
      return null;
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")

      Dim sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
      Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "Default Web Site")
      If (siteElement Is Nothing) Then
         Throw New InvalidOperationException("Element not found!")
      End If

      Dim applicationDefaultsElement As ConfigurationElement = siteElement.GetChildElement("applicationDefaults")
      applicationDefaultsElement("applicationPool") = "DefaultAppPool"

      serverManager.CommitChanges()
   End Sub

   Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
      For Each element As ConfigurationElement In collection
         If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
            Dim matches As Boolean = True
            Dim i As Integer
            For i = 0 To keyValues.Length - 1 Step 2
               Dim o As Object = element.GetAttributeValue(keyValues(i))
               Dim value As String = Nothing
               If (Not (o) Is Nothing) Then
                  value = o.ToString
               End If
               If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
                  matches = False
                  Exit For
               End If
            Next
            If matches Then
               Return element
            End If
         End If
      Next
      Return Nothing
   End Function


End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");

var sitesCollection = sitesSection.Collection;
var siteElementPos = FindElement(sitesCollection, "site", ["name", "Default Web Site"]);
if (siteElementPos == -1) throw "Element not found!";
var siteElement = sitesCollection.Item(siteElementPos);

var applicationDefaultsElement = siteElement.ChildElements.Item("applicationDefaults");
applicationDefaultsElement.Properties.Item("applicationPool").Value = "DefaultAppPool";

adminManager.CommitChanges();

function FindElement(collection, elementTagName, valuesToMatch) {
   for (var i = 0; i < collection.Count; i++) {
      var element = collection.Item(i);
      if (element.Name == elementTagName) {
         var matches = true;
         for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
            var property = element.GetPropertyByName(valuesToMatch[iVal]);
            var value = property.Value;
            if (value != null) {
               value = value.toString();
            }
            if (value != valuesToMatch[iVal + 1]) {
               matches = false;
               break;
            }
         }
         if (matches) {
            return i;
         }
      }
   }
   return -1;
}

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")

Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "Default Web Site"))
If (siteElementPos = -1) Then
   WScript.Echo "Element not found!"
   WScript.Quit
End If
Set siteElement = sitesCollection.Item(siteElementPos)

Set applicationDefaultsElement = siteElement.ChildElements.Item("applicationDefaults")
applicationDefaultsElement.Properties.Item("applicationPool").Value = "DefaultAppPool"

adminManager.CommitChanges()

Function FindElement(collection, elementTagName, valuesToMatch)
   For i = 0 To CInt(collection.Count) - 1
      Set element = collection.Item(i)
      If element.Name = elementTagName Then
         matches = True
         For iVal = 0 To UBound(valuesToMatch) Step 2
            Set property = element.GetPropertyByName(valuesToMatch(iVal))
            value = property.Value
            If Not IsNull(value) Then
               value = CStr(value)
            End If
            If Not value = CStr(valuesToMatch(iVal + 1)) Then
               matches = False
               Exit For
            End If
         Next
         If matches Then
            Exit For
         End If
      End If
   Next
   If matches Then
      FindElement = i
   Else
      FindElement = -1
   End If
End Function