Padrões do aplicativo <applicationDefaults>
Visão geral
O elemento <applicationDefaults> do elemento <site> especifica as configurações padrão de aplicativo para todos os aplicativos no site pai.
Observação
Se o mesmo atributo ou elemento filho estiver configurado nas seções <applicationDefaults> e <application> para um aplicativo específico, a configuração na seção <application> será usada para esse aplicativo.
Compatibilidade
| Versão | Observações |
|---|---|
| IIS 10.0 | O elemento <applicationDefaults> não foi modificado no IIS 10.0. |
| IIS 8.5 | O elemento <applicationDefaults> não foi modificado no IIS 8.5. |
| IIS 8.0 | O atributo preLoadEnabled foi adicionado ao IIS 8.0. |
| IIS 7.5 | O elemento <applicationDefaults> foi atualizado para incluir os atributos serviceAutoStartEnabled e serviceAutoStartProvider. |
| IIS 7.0 | O elemento <applicationDefaults> da coleção <site> foi introduzido no IIS 7.0. |
| IIS 6,0 | O elemento <applicationDefaults> é análogo à definição de opções de aplicativo no nível do site na metabase do IIS 6.0. |
Instalação
O elemento <applicationDefaults> do elemento <site> está incluído na instalação padrão do IIS 7 e versões posteriores.
Instruções
Como definir as configurações de aplicativo padrão para um site
Abra o Gerenciador dos Serviços de Informações da Internet (IIS):
Caso você esteja usando o Windows Server 2012 ou o Windows Server 2012 R2:
- Na barra de tarefas, clique em Gerenciador do Servidor, em Ferramentas e em Gerenciador dos Serviços de Informações da Internet (IIS).
Se você estiver usando o Windows 8 ou Windows 8.1:
- Mantenha pressionada a tecla Windows, pressione a letra X e clique em Painel de Controle.
- Clique em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).
Caso você esteja usando o Windows Server 2008 ou o Windows Server 2008 R2:
- Na barra de tarefas, clique em Iniciar, vá para Ferramentas Administrativas e clique em Gerenciador dos Serviços de Informações da Internet (IIS).
Se você estiver usando o Windows Vista ou Windows 7:
- Na barra de tarefas, clique em Iniciar e, depois, em Painel de Controle.
- Clique duas vezes em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).
No painel Conexões, expanda o nome do servidor, expanda o nó Sites e clique no nome do site.
No painel Página Inicial do site, selecione Exibir Aplicativos no painel Ações.
No painel Aplicativo do site, clique em Definir Padrões do Aplicativo... no painel Ações.
Na caixa de diálogo Padrões do Aplicativo, especifique as configurações padrão de aplicativo para o site e clique em OK.
Configuração
Atributos
| Atributo | Descrição |
|---|---|
applicationPool |
Atributo de cadeia de caracteres opcional. Especifica o pool de aplicativos padrão ao qual todos os aplicativos no site pai são atribuídos. |
enabledProtocols |
Atributo de cadeia de caracteres opcional. Especifica os protocolos a serem usados para se comunicar com todos os aplicativos no site pai. |
path |
Atributo de cadeia de caracteres opcional. Especifica o caminho virtual padrão de todos os aplicativos no site pai. |
preLoadEnabled |
Atributo booliano opcional. Especifica que o IIS simula uma solicitação de usuário para a página padrão de um aplicativo ou diretório virtual para que ela seja inicializada. Na verdade, o IIS inicia o aplicativo quando o pool de aplicativos é iniciado sem ter recebido uma solicitação. Isso aumenta o desempenho executando tarefas de inicialização, como carregar módulos gerenciados e compilar código gerenciado. Nenhum log é gerado nos logs do IIS. A configuração startMode do pool de aplicativos deve ser definida como AlwaysRunning.O valor padrão é False. |
serviceAutoStartEnabled |
Atributo booliano opcional. true se o início automático estiver habilitado para este aplicativo; caso contrário, false. O valor padrão é false. |
serviceAutoStartProvider |
Atributo de cadeia de caracteres opcional. Especifica o nome do provedor de início automático que o WAS (Serviço de Ativação de Processos do Windows) usará se serviceAutoStartEnabled for definido como true.Nenhum valor padrão. |
Elementos filho
Nenhum.
Exemplo de configuração
O exemplo de configuração a seguir define o pool de aplicativos padrão para o site padrão como "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>
Exemplo de código
Os exemplos de código a seguir definem o pool de aplicativos padrão para o site padrão como "DefaultAppPool".
AppCmd.exe
appcmd.exe set config -section:system.applicationHost/sites "/[name='Default Web Site'].applicationDefaults.applicationPool:DefaultAppPool" /commit:apphost
Observação
Defina o parâmetro commit para apphost quando usar AppCmd.exe para definir essas configurações. Isso confirma as definições de configuração para a seção de local apropriado no arquivo 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