RequestValidator.IsValidRequestString Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
HTTP isteği verilerini içeren bir dizeyi doğrular.
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
Parametreler
- context
- HttpContext
Geçerli isteğin bağlamı.
- value
- String
Doğrulanması gereken HTTP isteği verileri.
- requestValidationSource
- RequestValidationSource
Doğrulanan istek verilerinin kaynağını temsil eden bir numaralandırma. Numaralandırma için olası değerler şunlardır:
QueryStringFormCookiesFilesRawUrlPathPathInfo-
Headers.
- collectionKey
- String
Doğrulanması gereken öğenin istek koleksiyonundaki anahtar. Bu parametre isteğe bağlıdır. Bu parametre, doğrulanması gereken veriler bir koleksiyondan alınırsa kullanılır. Doğrulanacak veriler bir koleksiyondan değilse, collectionKey olabilir null.
- validationFailureIndex
- Int32
Bu yöntem döndürdüğünde, istek koleksiyonundaki sorunlu veya geçersiz metnin sıfır tabanlı başlangıç noktasını gösterir. Bu parametre başlatılmamış olarak geçirilir.
Döndürülenler
true doğrulanacak dize geçerliyse; aksi takdirde , false.
Açıklamalar
İstek verilerinin özel doğrulamasını gerçekleştirmek için bu yöntemi uygularsınız. IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) yönteminin temel davranışı, ASP.NET siteler arası betik doğrulamasında tehlikeli dizeleri denetlemek için dahili olarak uyguladığı davranışa benzer. Daha fazla bilgi için bkz. Hows: ASP.NET'da Siteler Arası Betiği Engelleme.
Özel doğrulama mantığı bir hata algılarsa, bu yöntem hataya neden olan metnin başlangıç noktasını belirtmek için değerini döndürmelidir false ve sağlamalıdır validationFailureIndex . içindeki validationFailureIndex değeri 0 veya pozitif bir tamsayı olmalıdır.
İstek doğrulama denetimindeki mantık aşağıdaki gibi devam eder:
sınıfı HttpRequest , gelen veriler üzerinde null karakter kaldırma denetimi gerçekleştirir.
sınıfı HttpRequestIsValidRequestString yöntemini (temel yöntemin varsayılan uygulaması) veya yönteminin türetilmiş bir sürümünü çağırır.
IsValidRequestString yöntemi doğrulama hatası göstermek için
falsedöndürürse, ASP.NET bir hata dizesi oluşturur (gerekirse) ve bir HttpRequestValidationException özel durumu oluşturur.