RequestValidator.IsValidRequestString メソッド

定義

名前空間:
System.Web.Util
アセンブリ:
System.Web.dll

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

パラメーター

context
HttpContext

現在の要求のコンテキスト。

value
String

検証する HTTP 要求データ。

requestValidationSource
RequestValidationSource

検証対象の要求データのソースを表す列挙体。 列挙体に使用できる値を次に示します。

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

検証する項目の要求コレクション内のキー。 このパラメーターは省略可能です。 このパラメーターは、検証するデータがコレクションから取得される場合に使用されます。 検証するデータがコレクションからでない場合は、 collectionKey を nullできます。

validationFailureIndex
Int32

このメソッドから制御が戻るときに、要求コレクション内の問題のあるテキストまたは無効なテキストの 0 から始まる開始点を示します。 このパラメーターは初期化せずに渡されます。

返品

Boolean

true 検証する文字列が有効な場合。それ以外の場合は false。

注釈

このメソッドを実装して、要求データのカスタム検証を実行します。 IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) メソッドの基本動作は、クロスサイト スクリプティング検証で危険な文字列をチェックするために内部的に実装 ASP.NET 動作に似ています。 詳細については、「方法: ASP.NETを参照してください。

カスタム検証ロジックでエラーが検出された場合、このメソッドは false を返し、エラーの原因となったテキストの開始点を示す値を validationFailureIndex で指定する必要があります。 validationFailureIndexの値は、0 または正の整数である必要があります。

要求検証チェックのロジックは、次のように続行されます。

  • HttpRequest クラスは、受信データに対して null 文字の削除チェックを実行します。

  • HttpRequest クラスは、IsValidRequestString メソッド (基本メソッドの既定の実装) を呼び出すか、メソッドの派生バージョンを呼び出します。

  • IsValidRequestString メソッドが検証エラーを示すために false を返す場合、ASP.NET はエラー文字列 (必要な場合) を構築し、HttpRequestValidationException 例外をスローします。

適用対象