RequestValidator.IsValidRequestString Metodo

Definizione

Spazio dei nomi:

System.Web.Util

Assembly:

System.Web.dll

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 .