RequestValidator.IsValidRequestString Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Valide une chaîne qui contient des données de requête HTTP.
protected public:
virtual bool IsValidRequestString(System::Web::HttpContext ^ context, System::String ^ value, System::Web::Util::RequestValidationSource requestValidationSource, System::String ^ collectionKey, [Runtime::InteropServices::Out] int % validationFailureIndex);protected internal virtual bool IsValidRequestString (System.Web.HttpContext context, string value, System.Web.Util.RequestValidationSource requestValidationSource, string collectionKey, out int validationFailureIndex);abstract member IsValidRequestString : System.Web.HttpContext * string * System.Web.Util.RequestValidationSource * string * int -> bool
override this.IsValidRequestString : System.Web.HttpContext * string * System.Web.Util.RequestValidationSource * string * int -> boolProtected Friend Overridable Function IsValidRequestString (context As HttpContext, value As String, requestValidationSource As RequestValidationSource, collectionKey As String, ByRef validationFailureIndex As Integer) As BooleanParamètres
- context
- HttpContext
Le contexte de la requête actuelle.
- value
- String
Les données de requête HTTP à valider.
- requestValidationSource
- RequestValidationSource
Énumération représentant la source de données de requête en cours de validation. Voici les valeurs possibles pour l’énumération :
QueryStringFormCookiesFilesRawUrlPathPathInfoHeaders.
- collectionKey
- String
La clé dans la collection de requêtes de l’élément à valider. Ce paramètre est optionnel. Ce paramètre est utilisé si les données à valider sont obtenues à partir d’une collection. Si les données à valider ne proviennent pas d’une collection, collectionKey peut être null.
- validationFailureIndex
- Int32
Lorsque cette méthode est retournée, elle indique le point de départ de base zéro du texte problématique ou non valide dans la collection de requêtes. Ce paramètre est passé sans être initialisé.
Retours
true si la chaîne à valider est valide ; sinon false.
Remarques
Vous implémentez cette méthode pour effectuer une validation personnalisée des données de requête. Le comportement de base de la IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) méthode est semblable au comportement que ASP.NET implémente en interne pour vérifier les chaînes dangereuses dans la validation de script intersites. Pour plus d’informations, consultez How To: Prevent Cross-Site Scripting in ASP.NET.
Si la logique de validation personnalisée détecte une erreur, cette méthode doit retourner false et fournir une valeur pour validationFailureIndex indiquer le point de départ du texte qui a provoqué l’erreur. La valeur dans validationFailureIndex doit être 0 ou un entier positif.
La logique d’une vérification de validation de demande se poursuit comme suit :
La HttpRequest classe effectue une vérification de suppression de caractères Null sur les données entrantes.
La HttpRequest classe appelle la IsValidRequestString méthode (implémentation par défaut de la méthode de base) ou appelle une version dérivée de la méthode.
Si IsValidRequestString la méthode retourne
falsepour indiquer un échec de validation, ASP.NET construit une chaîne d’erreur (si nécessaire) et lève une HttpRequestValidationException exception.