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 メソッド (基本メソッドの既定の実装) を呼び出すか、 メソッドの派生バージョンを呼び出します。

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