RequestValidator.IsValidRequestString Méthode

Référence

Définition

Espace de noms:: System.Web.Util

Assembly:: System.Web.dll

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

Protected Friend Overridable Function IsValidRequestString (context As HttpContext, value As String, requestValidationSource As RequestValidationSource, collectionKey As String, ByRef validationFailureIndex As Integer) As Boolean

Paramè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 :

QueryString
Form
Cookies
Files
RawUrl
Path
PathInfo
Headers.

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

Boolean

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 false pour indiquer un échec de validation, ASP.NET construit une chaîne d’erreur (si nécessaire) et lève une HttpRequestValidationException exception.

S’applique à

Partager via