QueryString

QueryString 컬렉션은 HTTP 쿼리 문자열에서 변수 값을 검색합니다. HTTP 쿼리 문자열은 물음표(?) 다음의 값으로 지정됩니다. 한 쿼리 문자열을 작성하는 데에는 몇 가지 다른 프로세스를 사용할 수 있습니다. 예를 들어, 앵커 태그,

<A HREF= "example?string=this is a sample">string sample</A>

는 "this is a sample"이라는 값을 가지는 string이라는 변수를 작성합니다. 또한 쿼리 문자열은 양식을 보내거나 사용자가 브라우저의 주소란에 쿼리를 입력하여 만들 수도 있습니다.

구문

Request.QueryString(variable)[(index)|.Count]

매개 변수

variable: HTTP 쿼리 문자열에서 검색할 변수 이름을 지정합니다.
index: variable에 대한 여러 값 중 하나를 검색할 수 있도록 하는 선택적인 매개 변수입니다. 1부터 Request.QueryString(variable).Count까지의 정수 값이 될 수 있습니다.

주의

QueryString 컬렉션은 ServerVariables 컬렉션에 있는 QUERY_STRING 변수를 분석한 버전입니다. 이 컬렉션은 QUERY_STRING 변수를 이름별로 검색할 수 있도록 합니다. Request.QueryString(parameter) 값은 QUERY_STRING에서 발생하는 모든 매개 변수 값의 배열입니다. Request.QueryString(parameter).Count를 호출하여 한 매개 변수 값의 수를 파악할 수 있습니다. 변수에 여러 데이터 집합이 연결되어 있지 않다면 변수 값의 수는 1이며 변수 자체가 없다면 0입니다.

여러 데이터 집합 중 하나에서 QueryString 변수를 참조하려면 index에 대한 값을 지정해야 합니다. index 매개 변수는 1부터 Request.QueryString(variable).Count까지의 값이 될 수 있습니다. index에 값을 지정하지 않고 여러 QueryString 변수 중 하나를 참조하면, 데이터는 쉼표로 구분된 문자열로 반환됩니다.

Request.QueryString에 매개 변수를 사용하면 서버는 요청에 보내진 매개 변수를 분석하여 지정된 데이터를 반환합니다. 응용 프로그램에 분석되지 않은 QueryString 데이터가 필요하면 매개 변수 없이 Request.QueryString을 호출하여 이 데이터를 검색할 수 있습니다.

반복기를 사용하여 쿼리 문자열의 모든 데이터 값을 반복할 수 있습니다. 예를 들어, 다음 요청이 보내지고

http://localhost/script/directory/NAMES.ASP?Q=Fred&Q=Sally

Names.asp에 다음 스크립트가 포함되면

---NAMES.ASP---
<%
  For Each item In Request.QueryString("Q")
    Response.Write Request.QueryString("Q")(item) & "<BR>"
  Next
%>

Names.asp는 다음 내용을 표시합니다.

Fred
Sally

Count를 사용하여 위의 스크립트를 작성할 수도 있습니다.

<%
  For i = 1 To Request.QueryString("Q").Count    
    Response.Write Request.QueryString("Q")(i) & "<BR>"
  Next
%>

예제

클라이언트 요청

/scripts/directory-lookup.asp?name=fred&age=22

는 다음 QUERY_STRING 값을 반환합니다.

name=fred&age=22.

QueryString 컬렉션은 두 개의 구성원, name과 age를 포함합니다. 그런 다음 아래 스크립트를 사용할 수 있습니다.

Welcome,  <%= Request.QueryString("name") %>. 
Your age is  <%= Request.QueryString("age") %>.

결과는 다음과 같습니다.

Welcome, Fred. Your age is 22.

다음 스크립트를 사용하면

The unparsed query string is:  <%=Request.QueryString %>

결과는 다음과 같습니다.

The unparsed query string is: name=fred&age=22

적용

Request 개체