Classe HttpRedirectSection
Configure la redirection HTTP.
Syntaxe
class HttpRedirectSection : ConfigurationSectionWithCollection
Méthodes
Le tableau suivant répertorie les méthodes exposées par la classe HttpRedirectSection
.
Nom | Description |
---|---|
Ajouter | (Hérité de ConfigurationSectionWithCollection.) |
Clear | (Hérité de ConfigurationSectionWithCollection .) |
Get | (Hérité de ConfigurationSectionWithCollection .) |
GetAllowDefinition | (Hérité de ConfigurationSection.) |
GetAllowLocation | (Hérité de ConfigurationSection .) |
Remove | (Hérité de ConfigurationSectionWithCollection .) |
RevertToParent | (Hérité de ConfigurationSection .) |
SetAllowDefinition | (Hérité de ConfigurationSection .) |
SetAllowLocation | (Hérité de ConfigurationSection .) |
Propriétés
Le tableau suivant répertorie les propriétés exposées par la classe HttpRedirectSection
.
Nom | Description |
---|---|
ChildOnly |
Une valeur boolean de lecture/écriture. true si la destination de redirection se trouve dans un sous-répertoire de l'URL d'origine. Sinon, false . Par défaut, il s’agit de false . Ce paramètre avertit IIS que la redirection ne doit se produire qu'une seule fois et empêche les boucles infinies dans le moteur de substitution. |
Destination |
Valeur string de lecture/écriture obligatoire qui contient le nom de fichier, le chemin d'accès au répertoire ou l'URL vers laquelle l'utilisateur est redirigé. La chaîne peut inclure des variables de redirection pour passer des parties de l'URL d'origine avec l'URL de destination. Vous pouvez utiliser plusieurs variables dans la chaîne. |
Enabled |
Une valeur boolean de lecture/écriture. true si la redirection HTTP est activée. Sinon, false . Par défaut, il s’agit de false . |
ExactDestination |
Une valeur boolean de lecture/écriture. true si l'URL doit être considérée comme un emplacement absolu. Sinon, false . Un paramètre de true empêche le moteur de substitution d'ajouter la ressource demandée originale à l'URL de redirection. |
HttpRedirect |
Tableau de valeurs WildcardRedirectElement qui, en utilisant des critères de correspondance, redirigent le nom du fichier, le chemin d'accès au répertoire ou les requêtes d'URL vers les destinations spécifiées. |
HttpResponseStatus |
Énumération sint32 de lecture/écriture qui contient l'état de la réponse HTTP. Les valeurs possibles sont répertoriées plus loin dans la section Remarques. |
Location |
(Hérité de ConfigurationSection .) Une propriété clé. |
Path |
(Hérité de ConfigurationSection .) Une propriété clé. |
SectionInformation |
(Hérité de ConfigurationSection .) |
Sous-classes
Cette classe ne contient aucune sous-classe.
Notes
Le tableau suivant répertorie les valeurs possibles pour la propriété HttpResponseStatus
. La valeur par défaut est 302 (Found
).
Valeur | Mot clé | Description |
---|---|---|
301 | Permanent |
IIS indique au client web que l'emplacement de la ressource demandée a été modifié définitivement. Le nouvel emplacement est spécifié dans l'en-tête Location HTTP. Ce paramètre permet aux clients web qui enregistrent les liens URL HTTP de mettre à jour l'URL enregistrée avec le nouvel emplacement. |
302 | Found |
IIS requête au client web d'envoyer une nouvelle requête à l'emplacement spécifié dans l'en-tête Location HTTP. |
307 | Temporary |
IIS requête au navigateur web de réémettre une requête POST avec les données d'origine vers un nouvel emplacement. Normalement, lorsqu'un navigateur web émet une requête POST et reçoit un message de redirection 302 du serveur web, le navigateur émet une requête GET pour le nouvel emplacement. Cela entraîne la perte des données dans la requête POST d'origine. Si le navigateur reçoit une redirection 307, il peut réexécuter POST avec les données d'origine intactes. |
Exemple
Le premier exemple affiche toutes les propriétés de la classe HttpRedirectSection
, y compris les propriétés incorporées SectionInformation
et HttpRedirect
.
Le deuxième exemple crée quatre éléments de redirection à caractère générique et tente de les ajouter à la section du site web par défaut <httpRedirect>
. S'il existe des doublons, le code le signale ; dans le cas contraire, il ajoute des entrées. Enfin, il affiche le nouveau nombre de toutes les entrées et le caractère générique et la destination pour chacun d'eux.
' 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
Hiérarchie d'héritage
ConfigurationSectionWithCollection
HttpRedirectSection
Spécifications
Type | Description |
---|---|
Client | - IIS 7.0 sous Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sur Windows 10 |
Serveur | - IIS 7.0 sous Windows Server 2008 - IIS 7.5 sous Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016 |
Produit | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
Fichier MOF | WebAdministration.mof |
Voir aussi
Classe ConfigurationSectionWithCollection
Classe SectionInformation
Classe WildcardRedirectElement