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 IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) dasar metode ini seperti perilaku yang ASP.NET terapkan secara internal untuk memeriksa string berbahaya dalam validasi scripting lintas situs. Untuk informasi selengkapnya, lihat Cara: Mencegah Scripting Lintas Situs di ASP.NET.

Jika logika validasi kustom mendeteksi kesalahan, metode ini harus mengembalikan false dan memberikan nilai untuk validationFailureIndex 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 IsValidRequestString metode kembali false untuk menunjukkan kegagalan validasi, ASP.NET membuat string kesalahan (jika perlu) dan melemparkan HttpRequestValidationException pengecualian.