Classe HandlersSection

Armazena os manipuladores de uma URL.

Sintaxe

class HandlersSection : ConfigurationSectionWithCollection  

Métodos

A tabela a seguir lista os métodos expostos pela classe HandlersSection.

Nome	Descrição
Add	(Herdado de ConfigurationSectionWithCollection.)
Limpar	(Herdado de ConfigurationSectionWithCollection.)
Get	(Herdado de ConfigurationSectionWithCollection.)
GetAllowDefinition	(Herdado de ConfigurationSection.)
GetAllowLocation	(Herdado de ConfigurationSection.)
Remover	(Herdado de ConfigurationSectionWithCollection.)
RevertToParent	(Herdado de ConfigurationSection.)
SetAllowDefinition	(Herdado de ConfigurationSection.)
SetAllowLocation	(Herdado de ConfigurationSection.)

Propriedades

A tabela a seguir lista as propriedades expostas pela classe HandlersSection.

Nome	Descrição
AccessPolicy	Um sint32 que especifica a política de acesso para manipuladores. Os valores possíveis estão listados posteriormente na seção Comentários.
Handlers	Uma matriz de objetos HandlerAction.
Location	(Herdado de ConfigurationSection.) Uma propriedade chave.
Path	(Herdado de ConfigurationSection.) Uma propriedade chave.
SectionInformation	(Herdado de ConfigurationSection.)

Subclasses

Essa classe não contém subclasses.

Comentários

Essa classe corresponde à seção <handlers> no arquivo ApplicationHost.config.

A tabela a seguir lista os possíveis valores da propriedade AccessPolicy. O padrão é 1 (Read).

Valor	Palavra-chave	Descrição
0	None	Os manipuladores não têm direitos.
1	Read	Os manipuladores têm permissão de leitura para arquivos ou conteúdo de pastas. Observação: esse sinalizador foi chamado de AccessRead no IIS 6.0.
2	Write	Os manipuladores têm permissão para gravar em diretórios habilitados no servidor ou alterar o conteúdo de um arquivo habilitado para gravação. Observação: esse sinalizador foi chamado de AccessWrite no IIS 6.0.
4	Execute	Os manipuladores têm permissão para executar arquivos ou conteúdo de pastas, independentemente do tipo de arquivo. Observação: esse sinalizador foi chamado de AccessExecute no IIS 6.0.
16	Source	Os manipuladores poderão acessar o código-fonte do script, se o sinalizador Read ou Write também estiver definido. Se Read estiver definido, os manipuladores poderão ler o código-fonte. Se Write estiver definido, os manipuladores poderão gravar no código-fonte. O sinalizador Source não estará disponível o Read ou Write não estiver definido. Observação: esse sinalizador foi chamado de AccessSource no IIS 6.0.
512	Script	O manipulador tem permissão para executar scripts. Observação: esse sinalizador foi chamado de AccessScript no IIS 6.0.
1024	NoRemoteWrite	O manipulador não tem permissão para gravar remotamente. As solicitações remotas para criar ou alterar arquivos são negadas. Se o sinalizador Write também estiver definido, somente as solicitações do computador que está executando o servidor Web do IIS serão bem-sucedidas. Observação: esse sinalizador foi chamado de AccessNoRemoteWrite no IIS 6.0.
4096	NoRemoteRead	O manipulador não tem permissão para ler remotamente. As solicitações remotas para exibir arquivos são negadas. Se o sinalizador Read também estiver definido, somente as solicitações do computador que está executando o servidor Web do IIS serão bem-sucedidas. Observação: esse sinalizador foi chamado de AccessNoRemoteRead no IIS 6.0.
8192	NoRemoteExecute	O manipulador não tem permissão para executar remotamente. As solicitações remotas para executar aplicativos são negadas. Se o sinalizador Execute também estiver definido, somente as solicitações do computador que está executando o servidor Web do IIS serão bem-sucedidas. Observação: esse sinalizador foi chamado de AccessNoRemoteExecute no IIS 6.0.
16384	NoRemoteScript	O manipulador não tem permissão para executar scripts remotamente. As solicitações remotas para executar conteúdo dinâmico são negadas. Se o sinalizador Script também estiver definido, somente as solicitações do computador que está executando o servidor Web do IIS serão bem-sucedidas. Observação: esse sinalizador foi chamado de AccessNoRemoteScript no IIS 6.0.

Exemplo

Os exemplos a seguir adicionam e removem um manipulador da seção <handlers>.

Observação

Adicionar ou remover um elemento de configuração altera a seção de configuração subjacente, mas não a variável de objeto no script que representa a seção de configuração. Para que a alteração seja exibida nos seus scripts, você deve chamar o método Refresh_ do WMI na variável de objeto, depois de fazer a alteração. Essa ação atualizará a variável de objeto com os dados mais recentes do repositório de configuração.

' ----------------------------------------------------------  
' The first example adds a handler to the <handlers> section.  
' ----------------------------------------------------------  
' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the <handlers> section.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HandlersSection", oHandlersSection  
  
' Display the old handler names.  
WScript.Echo "---[Old Handler List]---"  
Call DisplayHandlers  
  
' Create a new handler.  
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "NewHandler"   
oHandler.Path="*.stm"   
oHandler.Verb="GET,POST"   
oHandler.Modules="ServerSideIncludeModule"   
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Call the WMI Refresh_ method to update the oHandlersSection object.  
oHandlersSection.Refresh_  
  
' Display the new handler names.   
WScript.Echo "---[New Handler List]---"  
Call DisplayHandlers  
  
' ----------------------------------------------------------------  
' The second example removes a handler by using the handler name.  
' ----------------------------------------------------------------  
' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the <handlers> section.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HandlersSection", oHandlersSection  
  
' Display the old handler names.  
WScript.Echo "---[Old Handler List]---"  
Call DisplayHandlers  
  
' Remove the CGI-exe handler by name.  
For Each oHandler In oHandlersSection.Handlers  
     If oHandler.Name = "CGI-exe" Then  
        oHandlersSection.Remove "Handlers", oHandler  
    End If   
Next  
  
' Call the WMI Refresh_ method to update the oHandlersSection object.  
oHandlersSection.Refresh_  
  
' Display the new list of handler names.   
WScript.Echo "---[New Handler List]---"  
Call DisplayHandlers  
  
' This is the sub that displays the handler names.  
Sub DisplayHandlers  
    WScript.Echo   
    For Each oHandler In oHandlersSection.Handlers  
        WScript.Echo "Handler Name: " & oHandler.Name  
    Next  
End Sub  
  

Hierarquia de herança

ConfigurationSection

ConfigurationSectionWithCollection

HandlersSection

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 ConfigurationSectionWithCollection
Classe HandlerAction