RequestValidator.IsValidRequestString Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Convalida una stringa che contiene i dati delle richieste 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 BooleanParametri
- 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 da convalidare. Di seguito sono riportati i valori possibili per l'enumerazione :
QueryStringFormCookiesFilesRawUrlPathPathInfo-
Headers.
- collectionKey
- String
Chiave nella raccolta di richieste dell'elemento da convalidare. Questo parametro è facoltativo. Questo parametro viene usato se i dati da convalidare vengono ottenuti da una raccolta. Se i dati da convalidare non provengono da una raccolta, collectionKey possono essere null.
- validationFailureIndex
- Int32
Quando termina, 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.
Valori restituiti
true se la stringa da convalidare è valida; in caso contrario, false.
Commenti
Questo metodo viene implementato per eseguire la convalida personalizzata dei dati della richiesta. Il comportamento di base del metodo IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) è simile al comportamento implementato ASP.NET internamente per verificare la presenza di stringhe pericolose nella convalida di scripting tra siti. Per altre informazioni, vedere Come: Impedire lo scripting tra siti in ASP.NET.
Se la logica di convalida personalizzata rileva un errore, questo metodo deve restituire false e fornire 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 numero intero positivo.
La logica in un controllo di convalida della richiesta procede come segue:
La HttpRequest classe esegue un controllo di rimozione dei caratteri Null sui dati in ingresso.
La HttpRequest classe chiama il IsValidRequestString metodo (l'implementazione predefinita del metodo di base) o chiama una versione derivata del metodo .
Se IsValidRequestString metodo restituisce
falseper indicare un errore di convalida, ASP.NET costruisce una stringa di errore (se necessario) e genera un'eccezione HttpRequestValidationException.