RequestValidator.IsValidRequestString Metode

Definisi

Ruang nama:
System.Web.Util
Rakitan:
System.Web.dll

Memvalidasi string yang berisi data permintaan 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

Parameter

context
HttpContext

Konteks permintaan saat ini.

value
String

Data permintaan HTTP untuk divalidasi.

requestValidationSource
RequestValidationSource

Enumerasi yang mewakili sumber data permintaan yang sedang divalidasi. Berikut ini adalah nilai yang mungkin untuk enumerasi:

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

Kunci dalam kumpulan permintaan item untuk divalidasi. Parameter ini bersifat opsional. Parameter ini digunakan jika data yang akan divalidasi diperoleh dari koleksi. Jika data yang akan divalidasi bukan dari koleksi, collectionKey bisa berupa null.

validationFailureIndex
Int32

Ketika metode ini kembali, menunjukkan titik awal berbasis nol dari teks yang bermasalah atau tidak valid dalam kumpulan permintaan. Parameter ini diteruskan tanpa diinisialisasi.

Mengembalikan

Boolean

true jika string yang akan divalidasi valid; jika tidak, false.

Keterangan

Anda menerapkan metode ini untuk melakukan validasi kustom data permintaan. Perilaku dasar metode IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) seperti perilaku yang ASP.NET terapkan secara internal untuk memeriksa string berbahaya dalam validasi skrip lintas situs. Untuk informasi selengkapnya, lihat Cara: Mencegah Pembuatan Skrip Lintas Situs di ASP.NET.

Jika logika validasi kustom mendeteksi kesalahan, metode ini harus mengembalikan false dan memberikan nilai validationFailureIndex untuk menunjukkan titik awal teks yang menyebabkan kesalahan. Nilai di validationFailureIndex harus 0 atau bilangan bulat positif.

Logika dalam pemeriksaan validasi permintaan berlanjut sebagai berikut:

  • Kelas HttpRequest melakukan pemeriksaan penghapusan karakter null pada data masuk.

  • Kelas HttpRequest memanggil IsValidRequestString metode (implementasi default metode dasar) atau memanggil versi turunan metode.

  • Jika metode mengembalikan untuk menunjukkan kegagalan validasi, ASP.NET membuat string kesalahan (jika perlu) dan melempar pengecualian />

Berlaku untuk