RequestValidator.IsValidRequestString Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Ověří řetězec, který obsahuje data požadavku 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
Parametry
- context
- HttpContext
Kontext aktuálního požadavku.
- value
- String
Data požadavku HTTP, která se mají ověřit.
- requestValidationSource
- RequestValidationSource
Výčet, který představuje zdroj dat požadavku, která se ověřují. Následující hodnoty jsou možné pro výčet:
QueryStringFormCookiesFilesRawUrlPathPathInfo-
Headers.
- collectionKey
- String
Klíč v kolekci žádostí položky k ověření. Tento parametr je volitelný. Tento parametr se používá, pokud se data, která se mají ověřit, získána z kolekce. Pokud data, která chcete ověřit, nejsou z kolekce, collectionKey může být null.
- validationFailureIndex
- Int32
Když tato metoda vrátí, označuje nulový výchozí bod problematického nebo neplatného textu v kolekci požadavků. Tento parametr se předává neinicializovaný.
Návraty
truepokud je řetězec, který má být ověřen, platný; v opačném případě . false
Poznámky
Tuto metodu implementujete k provedení vlastního ověření dat požadavku. Základní chování metody IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) je podobné chování, které ASP.NET interně implementuje kontrolu nebezpečných řetězců při ověřování skriptování mezi weby. Další informace najdete v tématu Pokud chcete zabránit skriptování mezi weby v ASP.NET.
Pokud vlastní logika ověřování zjistí chybu, měla by tato metoda vrátit false a poskytnout hodnotu validationFailureIndex označující výchozí bod textu, který chybu způsobil. Hodnota validationFailureIndex musí být 0 nebo kladné celé číslo.
Logika kontroly ověření požadavku pokračuje následujícím způsobem:
Třída HttpRequest provádí kontrolu odebrání znaku null u příchozích dat.
HttpRequest Třída volá buď metodu IsValidRequestString (výchozí implementaci základní metody), nebo volá odvozenou verzi metody.
Pokud metoda IsValidRequestString vrátí
falsek označení chyby ověření, ASP.NET vytvoří řetězec chyby (v případě potřeby) a vyvolá výjimku HttpRequestValidationException.