RequestValidator.IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) Метод

Определение

Проверяет строку, содержащую данные HTTP-запроса.Validates a string that contains HTTP request data.

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

Контекст текущего запроса.The context of the current request.

value
String

Данные HTTP-запроса для проверки.The HTTP request data to validate.

requestValidationSource
RequestValidationSource

Перечисление, представляющее источник данных запроса, подлежащих проверке.An enumeration that represents the source of request data that is being validated. Ниже приведены возможные значения для перечисления.The following are possible values for the enumeration:

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

Ключ в коллекции запроса элемента для проверки.The key in the request collection of the item to validate. Это необязательный параметр.This parameter is optional. Этот параметр используется, если данные для проверки получены из коллекции.This parameter is used if the data to validate is obtained from a collection. Если данные для проверки не из коллекции, параметр collectionKey может иметь значение null.If the data to validate is not from a collection, collectionKey can be null.

validationFailureIndex
Int32

После выполнения возврата этим методом указывается отсчитываемая от нуля начальная точка проблемного или недопустимого текста в коллекции запроса.When this method returns, indicates the zero-based starting point of the problematic or invalid text in the request collection. Этот параметр передается неинициализированным.This parameter is passed uninitialized.

Возвращаемое значение

Boolean

Значение true, если строка для проверки допустимая. В противном случае — false.true if the string to be validated is valid; otherwise, false.

Комментарии

Этот метод реализуется для выполнения пользовательской проверки данных запроса.You implement this method to perform custom validation of request data. Базовое поведение IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) метода аналогично поведению, которое ASP.NET реализует внутренним образом для проверки опасных строк при проверке межсайтовых сценариев.The base behavior of the IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) method is like the behavior that ASP.NET implements internally to check for dangerous strings in cross-site scripting validation. Дополнительные сведения см. в разделе инструкции. Предотвращение межсайтовых сценариев в ASP.NET.For more information, see How To: Prevent Cross-Site Scripting in ASP.NET.

Если пользовательская логика проверки обнаруживает ошибку, этот метод должен возвращать false значение, а в параметре validationFailureIndex указать начальную точку текста, вызвавшего ошибку.If custom validation logic detects an error, this method should return false and provide a value in validationFailureIndex to indicate the starting point of the text that caused the error. Значение в validationFailureIndex должно быть равно 0 или положительному целому числу.The value in validationFailureIndex must be 0 or a positive integer.

Логика проверки запроса продолжается следующим образом.The logic in a request validation check proceeds as follows:

  • HttpRequestКласс выполняет проверку на наличие пустых символов для входящих данных.The HttpRequest class performs a null-character removal check on the incoming data.

  • HttpRequestКласс вызывает IsValidRequestString метод (реализацию базового метода по умолчанию) или вызывает производную версию метода.The HttpRequest class calls either the IsValidRequestString method (the default implementation of the base method) or calls a derived version of the method.

  • Если IsValidRequestString метод возвращает false значение, указывающее на сбой проверки, ASP.NET создает строку ошибки (при необходимости) и создает HttpRequestValidationException исключение.If IsValidRequestString method returns false to indicate a validation failure, ASP.NET constructs an error string (if necessary) and throws an HttpRequestValidationException exception.

Применяется к