RequestValidator.IsValidRequestString 메서드

정의

네임스페이스:

System.Web.Util

어셈블리:

System.Web.dll

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

매개 변수

context

HttpContext

현재 요청의 컨텍스트입니다.

value

String

유효성을 검사할 HTTP 요청 데이터입니다.

requestValidationSource

RequestValidationSource

유효성 검사 중인 요청 데이터의 소스를 나타내는 열거형입니다. 이 열거형에 사용할 수 있는 값은 다음과 같습니다.

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

collectionKey

String

유효성을 검사할 항목의 요청 컬렉션에 있는 키입니다. 이 매개 변수는 선택 사항입니다. 이 매개 변수는 유효성을 검사할 데이터를 컬렉션에서 가져오는 경우에 사용됩니다. 유효성을 검사할 데이터가 컬렉션에 없으면 collectionKey는 null일 수 있습니다.

validationFailureIndex

Int32

이 메서드가 반환하는 경우 요청 컬렉션에서 문제가 있거나 잘못된 텍스트의 0부터 시작하는 지점을 나타냅니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반환

Boolean

유효성을 검사할 문자열이 올바르면 true이고, 그렇지 않으면 false입니다.

설명

이 메서드를 구현하여 요청 데이터의 사용자 지정 유효성 검사를 수행합니다. 메서드의 IsValidRequestString(HttpContext, String, RequestValidationSource, String, Int32) 기본 동작은 ASP.NET 교차 사이트 스크립팅 유효성 검사에서 위험한 문자열을 확인하기 위해 내부적으로 구현하는 동작과 같습니다. 자세한 내용은 방법: ASP.NET 교차 사이트 스크립팅 방지를 참조하세요.

사용자 지정 유효성 검사 논리에서 오류를 감지하는 경우 이 메서드는 오류를 발생시킨 텍스트의 시작점을 나타내는 값을 validationFailureIndex 반환 false 하고 제공해야 합니다. 값 validationFailureIndex 은 0이거나 양의 정수여야 합니다.

요청 유효성 검사의 논리는 다음과 같이 진행됩니다.

• 클래스는 HttpRequest 들어오는 데이터에 대해 null 문자 제거 검사를 수행합니다.

• 클래스는 HttpRequest 메서드(기본 메서드의 기본 구현)를 호출 IsValidRequestString 하거나 메서드의 파생 버전을 호출합니다.

• 메서드가 유효성 검사 실패를 나타내기 위해 반환 false 되면 IsValidRequestString ASP.NET 오류 문자열(필요한 경우)을 생성하고 예외를 HttpRequestValidationException throw합니다.