RequestValidator.IsValidRequestString Metoda

Definice

Obor názvů:

System.Web.Util

Sestavení:

System.Web.dll

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žadavků, která se ověřují. Níže jsou možné hodnoty výčtu:

• QueryString
• Form
• Cookies
• Files
• RawUrl
• Path
• PathInfo
• Headers.

collectionKey

String

Klíč v kolekci požadavků položky k ověření. Tento parametr je volitelný. Tento parametr se používá, pokud se data k ověření získávají 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

Boolean

truepokud je řetězec, který se má ověřit, 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 je podobné chování, které ASP.NET implementuje interně kontrolu nebezpečných IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) řetězců při ověřování skriptování mezi weby. Další informace najdete v tématu Postupy: Zabránění skriptování mezi weby v ASP.NET.

Pokud vlastní logika ověřování zjistí chybu, měla by se tato metoda vrátit false a poskytnout hodnotu, která validationFailureIndex označuje výchozí bod textu, který chybu způsobil. Hodnota validationFailureIndex musí být 0 nebo kladné celé číslo.

Logika v kontrole ověření požadavku pokračuje následujícím způsobem:

• Třída HttpRequest provádí kontrolu odebrání znaku null na příchozích datech.

• Třída HttpRequest volá metodu IsValidRequestString (výchozí implementaci základní metody) nebo volá odvozenou verzi metody.

• Pokud IsValidRequestString se metoda vrátí false k označení chyby ověření, ASP.NET vytvoří chybový řetězec (v případě potřeby) a vyvolá HttpRequestValidationException výjimku.