次の方法で共有


RequestValidator.IsValidRequestString メソッド

定義

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

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

validationFailureIndex
Int32

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

戻り値

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

注釈

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

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

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

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

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

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

適用対象