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à
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