Condividi tramite


RequestValidator.IsValidRequestString Metodo

Definizione

Convalida una stringa che contiene i dati della richiesta 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

Parametri

context
HttpContext

Contesto della richiesta corrente.

value
String

Dati della richiesta HTTP da convalidare.

requestValidationSource
RequestValidationSource

Enumerazione che rappresenta l'origine dei dati della richiesta che vengono sottoposti a convalida. Di seguito sono indicati i valori possibili per l'enumerazione:

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

Chiave nella raccolta di richieste dell'elemento da convalidare. Questo parametro è facoltativo e, Questo parametro viene usato se i dati da convalidare sono ottenuti da una raccolta. In caso contrario, collectionKey può essere null.

validationFailureIndex
Int32

Quando restituisce il controllo, questo metodo indica il punto iniziale in base zero del testo problematico o non valido nella raccolta di richieste. Questo parametro viene passato non inizializzato.

Restituisce

true se la stringa da convalidare è valida. In caso contrario, false.

Commenti

Si implementa questo metodo per eseguire la convalida personalizzata dei dati della richiesta. Il comportamento di base del IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) metodo è simile al comportamento che ASP.NET implementa internamente per verificare la presenza di stringhe pericolose nella convalida dello scripting tra siti. Per altre informazioni, vedere Procedura: Impedire lo script tra siti in ASP.NET.

Se la logica di convalida personalizzata rileva un errore, questo metodo deve restituire false e specificare un valore in validationFailureIndex per indicare il punto iniziale del testo che ha causato l'errore. Il valore in validationFailureIndex deve essere 0 o un intero positivo.

La logica in un controllo di convalida della richiesta procede come segue:

Si applica a