Partager via


IAppHostPropertySchema ::ValidationType, propriété

Décrit le type de validation qui sera effectué pour la propriété actuelle.

Syntaxe

HRESULT get_ValidationType(  
   [out,  
   retval,  
   string] BSTR* pbstrValidationType  
);  

Paramètres

pbstrValidationType
Pointeur vers un BSTR qui indique le type de validation. Les valeurs valides sont « applicationPath », « applicationPoolName », « integerRange », « nonEmptyString », « siteName », « timeSpanRange », « requireTrimmedString » et « virtualDirectoryPath ».

Valeur renvoyée

Élément HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Valeur Description
S_OK Indique que l’opération a réussi.

Remarques

La validation d’attribut est effectuée lorsque le code XML est analysé et lorsque l’API effectue un appel pour définir une valeur dans le système de configuration.

Le tableau suivant fournit les types de validation disponibles.

Type de validation Description
applicationPoolName La validation échoue si la valeur de la propriété contient l’un des caractères suivants : &#124;<>&\"/[]+= ;:, ?* @

L’exemple suivant entraîne un échec de validation si la valeur de la propriété inclut l’un des caractères restreints.

validationType="applicationPoolName"

validationParameter=""
integerRange Syntaxe : <minimum>,<maximum>[,exclude]

La validation échoue si la valeur de la propriété est définie sur une valeur en dehors de la plage spécifiée.

L’exemple suivant entraîne un échec de validation si la propriété est définie sur une valeur inférieure à 1 ou supérieure à 10.

validationType="integerRange"

validationParameter="1,10,exclude"
nonEmptyString La validation échoue si la valeur de la propriété est définie sur une chaîne vide.

L’exemple suivant entraîne un échec de validation si la valeur de la propriété est définie sur une chaîne vide.

validationType="nonEmptyString"

validationParameter=""
siteName La validation échoue si la valeur de la propriété contient l’un des caractères suivants : /\.?

L’exemple suivant entraîne un échec de validation si la valeur de la propriété inclut l’un des caractères restreints.

validationType="siteName"

validationParameter=""
timeSpanRange Syntaxe : <minimum>,<maximum>,<granularity>[,exclude]

La validation échoue si la valeur de la propriété est définie sur une valeur en dehors de la plage spécifiée. La <granularity> valeur 60 indique que l’intervalle de temps représente les secondes et la valeur 1 indique que l’intervalle de temps représente des minutes.

L’exemple suivant entraîne un échec de validation si la propriété est définie sur une valeur inférieure à 1 ou supérieure à 2592000.

validationType="timeSpanRange"

validationParameter="1,2592000,60"
requireTrimmedString La validation échoue si des espaces blancs sont trouvés au début ou à la fin de la valeur de propriété.

L’exemple suivant entraîne un échec de validation si la valeur de la propriété contient des espaces blancs au début ou à la fin de la valeur.

validationType="requireTrimmedString"

validationParameter=""

Configuration requise

Type Description
Client - IIS 7.0 sur Windows Vista
- IIS 7.5 sur Windows 7
- IIS 8.0 sur Windows 8
- IIS 10.0 sur Windows 10
Serveur - IIS 7.0 sur Windows Server 2008
- IIS 7.5 sur 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
- IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
En-tête Ahadmin.h

Voir aussi

IAppHostPropertySchema, interface
IAppHostPropertySchema ::ValidationParameter, propriété