RequestValidator.IsValidRequestString Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Verifierar en sträng som innehåller HTTP-begärandedata.
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
Parametrar
- context
- HttpContext
Kontexten för den aktuella begäran.
- value
- String
HTTP begär att data verifieras.
- requestValidationSource
- RequestValidationSource
En uppräkning som representerar den källa för begärandedata som verifieras. Följande är möjliga värden för uppräkningen:
QueryStringFormCookiesFilesRawUrlPathPathInfo-
Headers.
- collectionKey
- String
Nyckeln i begärandesamlingen för objektet som ska verifieras. Den här parametern är valfri. Den här parametern används om data som ska verifieras hämtas från en samling. Om de data som ska verifieras inte kommer från en samling collectionKey kan vara null.
- validationFailureIndex
- Int32
När den här metoden returnerar anger du den nollbaserade startpunkten för den problematiska eller ogiltiga texten i begärandesamlingen. Den här parametern skickas oinitierad.
Returer
trueom strängen som ska verifieras är giltig; annars . false
Kommentarer
Du implementerar den här metoden för att utföra anpassad validering av begärandedata. Grundbeteendet för metoden IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) är som det beteende som ASP.NET implementerar internt för att söka efter farliga strängar i skriptvalidering mellan webbplatser. Mer information finns i How To: Prevent Cross-Site Scripting in ASP.NET.
Om anpassad valideringslogik identifierar ett fel bör den här metoden returnera false och ange ett värde i validationFailureIndex för att ange startpunkten för den text som orsakade felet. Värdet i validationFailureIndex måste vara 0 eller ett positivt heltal.
Logiken i en valideringskontroll av begäran fortsätter på följande sätt:
Klassen HttpRequest utför en borttagningskontroll med null-tecken på inkommande data.
Klassen HttpRequest anropar antingen IsValidRequestString metoden (standardimplementeringen av basmetoden) eller anropar en härledd version av metoden.
Om metoden IsValidRequestString returnerar
falseför att indikera ett valideringsfel konstruerar ASP.NET en felsträng (om det behövs) och utlöser ett HttpRequestValidationException undantag.