RequestValidator.IsValidRequestString Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Valideert een tekenreeks die HTTP-aanvraaggegevens bevat.
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 BooleanParameters
- context
- HttpContext
De context van de huidige aanvraag.
- value
- String
De HTTP-aanvraaggegevens die moeten worden gevalideerd.
- requestValidationSource
- RequestValidationSource
Een opsomming die de bron van aanvraaggegevens vertegenwoordigt die wordt gevalideerd. Hier volgen mogelijke waarden voor de opsomming:
QueryStringFormCookiesFilesRawUrlPathPathInfo-
Headers.
- collectionKey
- String
De sleutel in de aanvraagverzameling van het item dat moet worden gevalideerd. Deze parameter is optioneel. Deze parameter wordt gebruikt als de gegevens die moeten worden gevalideerd, worden verkregen uit een verzameling. Als de te valideren gegevens niet afkomstig zijn van een verzameling, collectionKey kan dat zijn null.
- validationFailureIndex
- Int32
Wanneer deze methode wordt geretourneerd, geeft u het op nul gebaseerde beginpunt van de problematische of ongeldige tekst in de aanvraagverzameling aan. Deze parameter wordt niet-geïnitialiseerd doorgegeven.
Retouren
true als de tekenreeks die moet worden gevalideerd, geldig is; anders, false.
Opmerkingen
U implementeert deze methode om aangepaste validatie van aanvraaggegevens uit te voeren. Het basisgedrag van de methode IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) is vergelijkbaar met het gedrag dat ASP.NET intern implementeert om te controleren op gevaarlijke tekenreeksen in validatie van scripts op meerdere sites. Zie How To: Cross-Site Scripting voorkomen in ASP.NET voor meer informatie.
Als met aangepaste validatielogica een fout wordt gedetecteerd, moet deze methode een waarde retourneren false en een waarde validationFailureIndex opgeven om het beginpunt aan te geven van de tekst die de fout heeft veroorzaakt. De waarde in validationFailureIndex moet 0 of een positief geheel getal zijn.
De logica in een aanvraagvalidatiecontrole wordt als volgt uitgevoerd:
De HttpRequest klasse voert een verwijderingscontrole met null tekens uit op de binnenkomende gegevens.
De HttpRequest klasse roept de IsValidRequestString methode aan (de standaard implementatie van de basismethode) of roept een afgeleide versie van de methode aan.
Als IsValidRequestString-methode
falseretourneert om een validatiefout aan te geven, ASP.NET een fouttekenreeks maakt (indien nodig) en een HttpRequestValidationException uitzondering genereert.
