RequestValidator.IsValidRequestString Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.Util

Assembly:: System.Web.dll

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 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

Boolean

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:

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 base) o chiama una versione derivata del metodo.
Se IsValidRequestString il metodo restituisce false un errore di convalida, ASP.NET costruisce una stringa di errore (se necessario) e genera un'eccezione HttpRequestValidationException .

Si applica a