RequestValidator.IsValidRequestString Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Valida uma cadeia de caracteres que contém dados de solicitação 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 da solicitação atual.
- value
- String
Os dados de solicitação HTTP a serem validados.
- requestValidationSource
- RequestValidationSource
Uma enumeração que representa a fonte de dados de solicitação que está sendo validada. Veja a seguir os valores possíveis para a enumeração:
QueryStringFormCookiesFilesRawUrlPathPathInfo-
Headers.
- collectionKey
- String
A chave na coleção de solicitações do item a ser validado. Esse parâmetro é opcional. Esse parâmetro será usado se os dados a serem validados forem obtidos de uma coleção. Se os dados a serem validados não forem de uma coleção, collectionKey poderá ser null.
- validationFailureIndex
- Int32
Quando esse método retorna, indica o ponto inicial baseado em zero do texto problemático ou inválido na coleção de solicitações. Esse parâmetro é passado sem inicialização.
Retornos
true se a cadeia de caracteres a ser validada for válida; caso contrário, false.
Comentários
Implemente esse método para executar a validação personalizada dos dados de solicitação. O comportamento base do método IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) é como o comportamento que ASP.NET implementa internamente para verificar se há cadeias de caracteres perigosas na validação de script entre sites. Para obter mais informações, consulte How To: Prevent Cross-Site Scripting in ASP.NET.
Se a lógica de validação personalizada detectar um erro, esse método deverá retornar false e fornecer um valor validationFailureIndex para indicar o ponto inicial do texto que causou o erro. O valor deve validationFailureIndex ser 0 ou um inteiro positivo.
A lógica em uma verificação de validação de solicitação prossegue da seguinte maneira:
A HttpRequest classe executa uma verificação de remoção de caractere nulo nos dados de entrada.
A HttpRequest classe chama o IsValidRequestString método (a implementação padrão do método base) ou chama uma versão derivada do método.
Se IsValidRequestString método retornar
falsepara indicar uma falha de validação, ASP.NET construirá uma cadeia de caracteres de erro (se necessário) e gerará uma exceção HttpRequestValidationException.