Condividi tramite


Classe HttpRedirectSection

Configura il reindirizzamento HTTP.

Sintassi

class HttpRedirectSection : ConfigurationSectionWithCollection  

Metodi

Nella tabella seguente sono elencati i metodi esposti dalla HttpRedirectSection classe .

Nome Descrizione
Aggiungere Ereditato da ConfigurationSectionWithCollection.
Cancella Ereditato da ConfigurationSectionWithCollection.
Recupero Ereditato da ConfigurationSectionWithCollection.
GetAllowDefinition Ereditato da ConfigurationSection.
GetAllowLocation Ereditato da ConfigurationSection.
Rimuovi Ereditato da ConfigurationSectionWithCollection.
RevertToParent Ereditato da ConfigurationSection.
SetAllowDefinition Ereditato da ConfigurationSection.
SetAllowLocation Ereditato da ConfigurationSection.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla HttpRedirectSection classe .

Nome Descrizione
ChildOnly Valore di lettura/scrittura boolean . true se la destinazione di reindirizzamento si trova in una sottodirectory dell'URL originale; in caso contrario, false. Il valore predefinito è false. Questa impostazione avvisa IIS che il reindirizzamento deve essere eseguito una sola volta e impedisce cicli infiniti nel motore di sostituzione.
Destination Valore di lettura/scrittura string obbligatorio che contiene il nome file, il percorso della directory o l'URL a cui viene reindirizzato l'utente. La stringa può includere variabili di reindirizzamento per passare parti dell'URL originale con l'URL di destinazione. È possibile usare più di una variabile nella stringa.
Enabled Valore di lettura/scrittura boolean . true se il reindirizzamento HTTP è abilitato; in caso contrario, false. Il valore predefinito è false.
ExactDestination Valore di lettura/scrittura boolean . true se l'URL deve essere considerato una posizione assoluta; in caso contrario, false. Un'impostazione di impedisce al motore di true sostituzione di accodare la risorsa richiesta originale all'URL di reindirizzamento.
HttpRedirect Matrice di valori WildcardRedirectElement che, utilizzando criteri corrispondenti, reindirizzare il nome del file, il percorso della directory o le richieste URL alle destinazioni specificate.
HttpResponseStatus Enumerazione di lettura/scrittura sint32 che contiene lo stato della risposta HTTP. I valori possibili sono elencati più avanti nella sezione Osservazioni.
Location Ereditato da ConfigurationSection. Proprietà chiave.
Path Ereditato da ConfigurationSection. Proprietà chiave.
SectionInformation Ereditato da ConfigurationSection.

Sottoclassi

Questa classe non contiene sottoclassi.

Commenti

Nella tabella seguente sono elencati i valori possibili per la HttpResponseStatus proprietà . Il valore predefinito è 302 (Found).

Valore Parola chiave Descrizione
301 Permanent IIS indica al client Web che il percorso della risorsa richiesta è stato modificato in modo permanente. Il nuovo percorso viene specificato nell'intestazione Location HTTP. Questa impostazione consente ai client Web che mantengono il record dei collegamenti URL HTTP per aggiornare l'URL archiviato con il nuovo percorso.
302 Found IIS indica al client Web di inviare una nuova richiesta al percorso specificato nell'intestazione Location HTTP.
307 Temporary IIS indica al Web browser di eseguire nuovamente una richiesta POST con dati originali in una nuova posizione. In genere, quando un Web browser invia una richiesta POST e riceve un messaggio di reindirizzamento 302 dal server Web, il browser invia una richiesta GET per il nuovo percorso. In questo modo i dati nella richiesta POST originale andranno persi. Se il browser riceve un reindirizzamento 307, può eseguire nuovamente il post con i dati originali intatti.

Esempio

Nel primo esempio vengono visualizzate tutte le proprietà della HttpRedirectSection classe, incluse le proprietà incorporate SectionInformation e HttpRedirect .

Il secondo esempio crea quattro elementi di reindirizzamento con caratteri jolly e tenta di aggiungerli alla sezione predefinita del <httpRedirect> sito Web. Se esistono voci duplicate, il codice segnala così; in caso contrario, aggiunge le nuove voci. Viene infine visualizzato il nuovo conteggio di tutte le voci e il carattere jolly e la destinazione per ognuno di essi.

' 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  
  

Gerarchia di ereditarietà

Configurationsection

ConfigurationSectionWithCollection

HttpRedirectSection

Requisiti

Tipo Descrizione
Client - IIS 7.0 in Windows Vista
- IIS 7.5 in Windows 7
- IIS 8.0 in Windows 8
- IIS 10.0 in Windows 10
Server - IIS 7.0 in Windows Server 2008
- IIS 7.5 in Windows Server 2008 R2
- IIS 8.0 in Windows Server 2012
- IIS 8.5 in Windows Server 2012 R2
- IIS 10.0 in Windows Server 2016
Prodotto - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
File MOF WebAdministration.mof

Vedere anche

Classe ConfigurationSectionWithCollection
Classe SectionInformation
Classe WildcardRedirectElement