RequestValidator.IsValidRequestString Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Valida uma cadeia que contém dados de pedido 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 -> boolProtected Friend Overridable Function IsValidRequestString (context As HttpContext, value As String, requestValidationSource As RequestValidationSource, collectionKey As String, ByRef validationFailureIndex As Integer) As BooleanParâmetros
- context
- HttpContext
O contexto do pedido atual.
- value
- String
O HTTP solicita dados para validar.
- requestValidationSource
- RequestValidationSource
Uma enumeração que representa a fonte dos dados do pedido que está a ser validado. Os seguintes são possíveis valores para a enumeração:
QueryStringFormCookiesFilesRawUrlPathPathInfo-
Headers.
- collectionKey
- String
A chave no pedido de recolha do item para validar. Este parâmetro é opcional. Este parâmetro é usado se os dados a validar forem obtidos a partir de uma coleção. Se os dados a validar não forem de uma coleção, collectionKey pode ser null.
- validationFailureIndex
- Int32
Quando este método retorna, indica o ponto de partida em base zero do texto problemático ou inválido na coleção de pedidos. Este parâmetro é passado sem inicializar.
Devoluções
true se a cadeia a validar for válida; caso contrário, false.
Observações
Implementa este método para realizar uma validação personalizada dos dados do pedido. O comportamento base do método IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) é semelhante ao comportamento que ASP.NET implementa internamente para verificar cadeias perigosas na validação cross-site scripting. Para mais informações, consulte Como Prevenir: Prevenir o Cross-Site Scripting em ASP.NET.
Se a lógica de validação personalizada detetar um erro, este método deve devolver false e fornecer um valor em validationFailureIndex para indicar o ponto de partida do texto que causou o erro. O valor em validationFailureIndex deve ser 0 ou um inteiro positivo.
A lógica numa verificação de validação de pedidos procede da seguinte forma:
A HttpRequest classe realiza uma verificação de remoção de caracteres nulos nos dados recebidos.
A HttpRequest classe chama ou o IsValidRequestString método (a implementação padrão do método base) ou chama uma versão derivada do método.
Se o método IsValidRequestString devolver
falsepara indicar uma falha de validação, ASP.NET constrói uma cadeia de erro (se necessário) e lança uma exceção HttpRequestValidationException.