Classe HttpRedirectSection

Artigo
03/25/2024

Configura o redirecionamento HTTP.

Sintaxe

class HttpRedirectSection : ConfigurationSectionWithCollection

Métodos

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

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 HttpRedirectSection.

Nome	Descrição
`ChildOnly`	Um valor `boolean` de leitura/gravação. `true` se o destino do redirecionamento estiver em um subdiretório da URL original; caso contrário, `false`. O padrão é `false`. Essa configuração alerta o IIS de que o redirecionamento deve ocorrer apenas uma vez e evita loops infinitos no mecanismo de substituição.
`Destination`	Um valor `string` de leitura/gravação obrigatório e não limitado que contém o nome do arquivo, o caminho do diretório ou a URL para o qual o usuário é redirecionado. A cadeia de caracteres pode incluir variáveis de redirecionamento para passar partes da URL original com a URL de destino. Você pode usar mais de uma variável na cadeia de caracteres.
`Enabled`	Um valor `boolean` de leitura/gravação. `true` se o redirecionamento HTTP estiver habilitado; caso contrário, `false`. O padrão é `false`.
`ExactDestination`	Um valor `boolean` de leitura/gravação. `true` se a URL deve ser considerada um local absoluto; caso contrário, `false`. Uma configuração de `true` impede que o mecanismo de substituição anexe o recurso solicitado original à URL de redirecionamento.
`HttpRedirect`	Uma matriz de valores WildcardRedirectElement que, usando critérios de correspondência, redirecionam o nome do arquivo, o caminho do diretório ou as solicitações de URL para destinos especificados.
`HttpResponseStatus`	Uma enumeração `sint32` de leitura/gravação que contém o status da resposta HTTP. Os valores possíveis estão listados posteriormente na seção Comentários.
`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

A tabela a seguir lista os possíveis valores da propriedade HttpResponseStatus. O padrão é 302 (Found).

Valor	Palavra-chave	Descrição
301	`Permanent`	O IIS informa ao cliente Web que o local do recurso solicitado foi alterado permanentemente. O novo local é especificado no cabeçalho HTTP `Location`. Essa configuração permite que os clientes da Web que mantêm registros de links de URL HTTP atualizem a URL armazenada com o novo local.
302	`Found`	O IIS informa ao cliente Web para emitir uma nova solicitação para o local especificado no cabeçalho HTTP `Location`.
307	`Temporary`	O IIS instrui o navegador da Web a reemitir uma solicitação POST com dados originais para um novo local. Normalmente, quando um navegador da Web emite uma solicitação POST e recebe uma mensagem de redirecionamento 302 do servidor Web, o navegador emite uma solicitação GET para o novo local. Isso faz com que os dados na solicitação POST original sejam perdidos. Se o navegador receber um redirecionamento 307, ele poderá reemitir o POST com os dados originais intactos.

Exemplo

O primeiro exemplo exibe todas as propriedades da classe HttpRedirectSection, incluindo as propriedades SectionInformation e HttpRedirect inseridas.

O segundo exemplo cria quatro elementos de redirecionamento curinga e tenta adicioná-los à seção <httpRedirect> do site padrão. Se existirem entradas duplicadas, o código informa isso; caso contrário, ele adiciona as novas entradas. Finalmente, ele exibe a nova contagem de todas as entradas e o caractere curinga e o destino de cada uma.

' 1) First example: Display the httpRedirect properties  
' for the default Web site.  
' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = _  
    GetObject("winmgmts:root\WebAdministration")  
  
' Get the httpRedirect section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HttpRedirectSection", oSection  
  
' Display the nonembedded properties.  
WScript.Echo "=============================="  
WScript.Echo "HttpRedirectSection Properties"  
WScript.Echo "=============================="  
For Each vProp In oSection.Properties_  
    If (vProp.Name <> "HttpRedirect") And _  
    (vProp.Name <> "SectionInformation") Then  
        WScript.Echo vProp.Name & ": " & vProp.Value  
    End If  
Next  
  
' Display the contents of the SectionInformation property.  
WScript.Echo   
WScript.Echo "--------------------------------------"  
WScript.Echo "HttpRedirectSection.SectionInformation"  
WScript.Echo "--------------------------------------"  
For Each vProp In oSection.SectionInformation.Properties_  
    WScript.Echo vProp.Name & ": " & vProp.Value  
Next  
WScript.Echo   
  
' Display the WildcardRedirectElement instances in the  
' HttpRedirect array property.  
WScript.Echo "--------------------------------"  
WScript.Echo "HttpRedirectSection.HttpRedirect"  
WScript.Echo "--------------------------------"  
For Each oWildcardRedirectElement In oSection.HttpRedirect  
    For Each vProp In oWildcardRedirectElement.Properties_  
        WScript.Echo vProp.Name & ": " & vProp.Value  
    Next  
    WScript.Echo  
Next  
  
' 2) Second example: Add four WildcardRedirectElement  
' instances to the default Web site and display the result.  
' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = _  
    GetObject("winmgmts:root\WebAdministration")  
  
' Get the httpRedirect section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HttpRedirectSection", oSection  
  
' Set up a loop to add four new redirects.  
For Counter = 1 To 4  
    ' Create a new instance of WildcardRedirectElement.  
    ' Note that you do not need to use SpawnInstance_.  
    Set oWildcardRedirect = _  
        oWebAdmin.Get("WildcardRedirectElement")  
  
    ' Specify the page to be redirected.  
    oWildcardRedirect.Wildcard = _  
        "Adatum.com/Page" & Counter & ".htm"  
  
    ' Specify the destination for the redirected page.  
    oWildcardRedirect.Destination = _  
        "Contoso.com/Page" & Counter & ".htm"  
  
    ' Prepare to catch duplicate entries.  
    On Error Resume Next  
  
    ' Attempt to add the wildcard entry to the collection.   
    ' (You do not need to use Put_ to save the change.)  
    oSection.Add "HttpRedirect", oWildcardRedirect  
  
    ' Catch duplicate entries.  
    If Err.Number = -2147024713 Then  
        WScript.Echo "Redirect entry for """ & _  
        oWildcardRedirect.Wildcard & """ already exists."  
        WScript.Echo  
    End If  
Next  
  
' Update the contents of the oSection variable.  
oSection.Refresh_  
  
' Display a header and the new number of entries.  
WScript.Echo "--------------------------------"  
WScript.Echo "HttpRedirectSection.HttpRedirect"  
WScript.Echo "--------------------------------"  
WScript.Echo "The number of redirect entries is now " & _  
    UBound(oSection.HttpRedirect) + 1 & "."  
WScript.Echo   
  
' Display the new set of wildcard redirect elements.  
For Each oWildcardRedirectElement In oSection.HttpRedirect  
    WScript.Echo "Wildcard: " & _  
        oWildcardRedirectElement.Wildcard & vbTab & _  
        "Destination: " & _  
        oWildcardRedirectElement.Destination  
    WScript.Echo  
Next

Hierarquia de herança

ConfigurationSection

ConfigurationSectionWithCollection

HttpRedirectSection

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 SectionInformation
Classe WildcardRedirectElement

Compartilhar via

Classe HttpRedirectSection

Sintaxe

Métodos

Propriedades

Subclasses

Comentários

Exemplo

Hierarquia de herança

Requisitos

Confira também

Comentários

Recursos adicionais