RequestValidator.IsValidRequestString Metoda

Definicja

Przestrzeń nazw:
System.Web.Util
Zestaw:
System.Web.dll

Sprawdza poprawność ciągu zawierającego dane żądania 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

Kontekst bieżącego żądania.

value
String

Dane żądania HTTP do zweryfikowania.

requestValidationSource
RequestValidationSource

Wyliczenie reprezentujące źródło zweryfikowanych danych żądania. Poniżej przedstawiono możliwe wartości dla wyliczenia:

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

Klucz w kolekcji żądań elementu do zweryfikowania. Ten parametr jest opcjonalny. Ten parametr jest używany, jeśli dane do walidacji są uzyskiwane z kolekcji. Jeśli dane do zweryfikowania nie pochodzą z kolekcji, collectionKey może to być null.

validationFailureIndex
Int32

Gdy ta metoda zwraca wartość , wskazuje zerowy punkt początkowy problematycznego lub nieprawidłowego tekstu w kolekcji żądań. Ten parametr jest przekazywany niezainicjowany.

Zwraca

Boolean

true jeśli ciąg do zweryfikowania jest prawidłowy; w przeciwnym razie, false.

Uwagi

Zaimplementujesz tę metodę, aby przeprowadzić niestandardową walidację danych żądania. Podstawowe zachowanie metody IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) przypomina zachowanie, które ASP.NET implementuje wewnętrznie, aby sprawdzić niebezpieczne ciągi w walidacji skryptów między witrynami. Aby uzyskać więcej informacji, zobacz Jak: zapobieganie skryptom między witrynami w ASP.NET.

Jeśli niestandardowa logika walidacji wykryje błąd, ta metoda powinna zwrócić false i podać wartość , validationFailureIndex aby wskazać punkt początkowy tekstu, który spowodował błąd. Wartość w validationFailureIndex musi być 0 lub dodatnią liczbą całkowitą.

Logika sprawdzania poprawności żądania jest kontynuowana w następujący sposób:

Dotyczy