RequestValidator.IsValidRequestString Método

Definición

Espacio de nombres:

System.Web.Util

Ensamblado:

System.Web.dll

Valida una cadena que contiene los datos de la solicitud 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

Parámetros

context

HttpContext

El contexto de la solicitud actual.

value

String

Datos de la solicitud HTTP que se van a validar.

requestValidationSource

RequestValidationSource

Enumeración que representa el origen de los datos de la solicitud que se van a validar. A continuación, se muestran los valores posibles de la enumeración:

• QueryString
• Form
• Cookies
• Files
• RawUrl
• Path
• PathInfo
• Headers.

collectionKey

String

Clave de la colección de solicitudes del elemento que se va a validar. Este parámetro es opcional. Este parámetro se usa si los datos que se va a validar se obtienen de una colección. Si los datos que se van a validar no están en una colección, collectionKey puede ser null.

validationFailureIndex

Int32

Cuando este método finaliza, indica el punto inicial de base cero del texto problemático o no válido de la colección de solicitud. Este parámetro se pasa sin inicializar.

Devoluciones

Boolean

Estrue si la cadena que se va a validar es válida; de lo contrario, es false.

Comentarios

Este método se implementa para realizar la validación personalizada de los datos de solicitud. El comportamiento base del IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) método es similar al comportamiento que ASP.NET implementa internamente para comprobar si hay cadenas peligrosas en la validación de scripts entre sitios. Para obtener más información, vea How To: Prevent Cross-Site Scripting in ASP.NET.

Si la lógica de validación personalizada detecta un error, este método debe devolver false y proporcionar un valor en validationFailureIndex para indicar el punto inicial del texto que provocó el error. El valor de validationFailureIndex debe ser 0 o un entero positivo.

La lógica de una comprobación de validación de solicitudes continúa de la siguiente manera:

• La HttpRequest clase realiza una comprobación de eliminación de caracteres NULL en los datos entrantes.

• La HttpRequest clase llama al IsValidRequestString método (la implementación predeterminada del método base) o llama a una versión derivada del método .

• Si IsValidRequestString el método devuelve false para indicar un error de validación, ASP.NET construye una cadena de error (si es necesario) y produce una HttpRequestValidationException excepción.