Classe ModuleAction
Representa uma entrada de módulo na seção <modules> de um arquivo de configuração.
Sintaxe
class ModuleAction : CollectionElement
Métodos
Essa classe não contém métodos.
Propriedades
A tabela a seguir lista as propriedades expostas pela classe ModuleAction.
| Nome | Descrição |
|---|---|
Name |
Um valor string de leitura/gravação obrigatório e exclusivo que contém o nome do módulo. A propriedade de chave. |
PreCondition |
Um valor string de leitura/gravação que contém uma lista delimitada por vírgulas de valores que representam as pré-condições do módulo a ser carregado. Os valores possíveis estão listados posteriormente na seção Comentários. |
Type |
Um valor string de leitura/gravação que especifica o tipo de um módulo gerenciado. |
Subclasses
Essa classe não contém subclasses.
Comentários
As instâncias dessa classe estão contidas na propriedade Modules da classe ModulesSection.
A tabela a seguir lista os possíveis valores da propriedade PreCondition. As configurações integratedMode e ISAPIMode são mutuamente exclusivas. O padrão é null.
| Valor | Descrição |
|---|---|
bitness32 |
O IIS carrega o módulo em um processo de trabalho de 32 bits. Essa configuração se aplica somente a sistemas operacionais de 64 bits. |
bitness64 |
O IIS carrega o módulo em um processo de trabalho de 64 bits. Essa configuração se aplica somente a sistemas operacionais de 64 bits. |
integratedMode |
O IIS carrega o módulo somente para pools de aplicativos executados no modo integrado. |
ISAPIMode |
O IIS carrega o módulo somente para pools de aplicativos executados no modo ISAPI. |
runtimeVersion |
O IIS carrega o módulo somente para pools de aplicativos que usam a versão especificada do .NET Framework. Para habilitar essa pré-condição, acrescente uma cadeia de caracteres no formato vMajorVersion.MinorVersion para a cadeia de caracteres "runtimeVersion" (por exemplo, "runtimeVersionv2.0"). |
managedHandler |
O IIS carregará o módulo somente se a solicitação for mapeada para um manipulador gerenciado. Essa configuração pode otimizar o desempenho, impedindo que arquivos estáticos usem módulos gerenciados para cada solicitação. |
Exemplo
O exemplo a seguir adiciona um módulo gerenciado ao arquivo Web.config raiz.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Get the modules section.
Set oModulesSection = _
oWebAdmin.Get("ModulesSection.Path=" & _
"'MACHINE/WEBROOT/APPHOST/Default Web Site',Location=''")
' Get the ModuleAction class.
Set oModuleAction = oWebAdmin.Get( "ModuleAction" )
' Spawn a new instance of the ModuleAction class.
Set oNewModule = oModuleAction.SpawnInstance_
' Assign values to the new module's Name and Type properties.
oNewModule.Name = "myNewModule2"
oNewModule.Type = "System.Web.Profile.ProfileModule2"
' Call the ModulesSection.Add method to add the new module.
' If the module entry already exists, the error "Cannot create a file
' when that file already exists." will be displayed.
oModulesSection.Add "Modules", oNewModule
' Alert user when done.
WScript.Echo "Done!"
Hierarquia de herança
ModuleAction
Requisitos
| Tipo | Descrição |
|---|---|
| Cliente | – IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10 |
| Servidor | – IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016 |
| Product | – IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Arquivo MOF | WebAdministration.mof |
Confira também
Classe CollectionElement
Classe GlobalModuleElement
Classe GlobalModulesSection
Classe ModulesSection