QueryStringParameter 클래스

참조

정의

네임스페이스:: System.Web.UI.WebControls

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

HTTP 요청 쿼리 문자열 필드의 값을 매개 변수 개체에 바인딩합니다.

public ref class QueryStringParameter : System::Web::UI::WebControls::Parameter

public class QueryStringParameter : System.Web.UI.WebControls.Parameter

type QueryStringParameter = class
    inherit Parameter

Public Class QueryStringParameter
Inherits Parameter

상속: Object

Parameter
QueryStringParameter

예제

다음 예제에서는 GridView 컨트롤에 데이터를 표시할 때 필터로 사용할 QueryStringParameter 개체를 만드는 방법을 보여 있습니다. AccessDataSource 컨트롤의 FilterParameters 컬렉션에 QueryStringParameter 개체를 추가합니다. 매개 변수 개체는 country 쿼리 문자열 필드의 값을 해당 FilterExpression 문자열에 바인딩합니다. 매개 변수에 대해 DefaultValue 속성이 지정되지 않으므로 쿼리 문자열과 함께 country 이름이 지정된 필드가 전달되지 않으면 AccessDataSource 컨트롤이 NullReferenceException 예외를 throw합니다. country 이름이 지정된 필드가 전달되었지만 값이 없으면 GridView 컨트롤에 데이터가 표시되지 않습니다.

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>
    </form>
  </body>
</html>

<%@ Page language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>

    </form>
  </body>
</html>

설명

QueryStringParameter 클래스를 사용하여 HTTP 요청 쿼리 문자열의 일부로 전달되는 필드 값을 매개 변수가 있는 쿼리 또는 명령에 사용되는 매개 변수에 바인딩할 수 있습니다. 필드는 QueryString 컬렉션에서 검색됩니다.

매개 변수에 데이터를 바인딩하는 컨트롤은 QueryStringParameter 개체를 참조하는 경우 예외를 throw할 수 있지만 해당 쿼리 문자열 이름/값 쌍은 전달되지 않습니다. 마찬가지로 쿼리 문자열 필드 이름이 해당 값 없이 전달되는 경우 데이터가 표시되지 않을 수 있습니다. 이러한 상황을 방지하려면 적절한 경우 DefaultValue 속성을 설정합니다.

QueryStringParameter 클래스는 바인딩할 쿼리 문자열 값의 이름을 식별하는 QueryStringField 속성을 제공합니다. 또한 Parameter 클래스에서 상속되는 속성을 제공합니다.

중요하다

QueryStringParameter 클래스는 전달된 값의 유효성을 검사하지 않습니다. 원시 값을 제공합니다. 그러나 데이터 소스 컨트롤에서 QueryStringParameter 개체의 값의 유효성을 검사할 수 있습니다. 이렇게 하려면 데이터 원본 제어의 Selecting, Updating, Inserting또는 Deleting 이벤트를 처리하고 이벤트 처리기에서 매개 변수 값을 확인합니다. 매개 변수 값이 유효성 검사 테스트를 통과하지 못하면 연결된 CancelEventArgs 클래스의 Cancel 속성을 true설정하여 데이터 작업을 취소할 수 있습니다.

생성자

QueryStringParameter()	QueryStringParameter 클래스의 명명되지 않은 새 인스턴스를 초기화합니다.
QueryStringParameter(QueryStringParameter)	`original` 매개 변수로 지정된 인스턴스의 값을 사용하여 QueryStringParameter 클래스의 새 인스턴스를 초기화합니다.
QueryStringParameter(String, DbType, String)	지정된 쿼리 문자열 필드와 매개 변수의 데이터 형식을 사용하여 QueryStringParameter 클래스의 명명된 새 인스턴스를 초기화합니다.
QueryStringParameter(String, String)	지정된 문자열을 사용하여 바인딩할 쿼리 문자열 필드를 식별하여 QueryStringParameter 클래스의 명명된 새 인스턴스를 초기화합니다.
QueryStringParameter(String, TypeCode, String)	지정된 문자열을 사용하여 바인딩할 쿼리 문자열 필드를 식별하여 QueryStringParameter 클래스의 명명되고 강력한 형식의 새 인스턴스를 초기화합니다.

속성

ConvertEmptyStringToNull	Parameter 개체가 바인딩된 값을 Empty경우 `null` 변환해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 Parameter)
DbType	매개 변수의 데이터베이스 형식을 가져오거나 설정합니다. (다음에서 상속됨 Parameter)
DefaultValue	Evaluate(HttpContext, Control) 메서드가 호출될 때 매개 변수가 초기화되지 않을 바인딩된 값인 경우 매개 변수의 기본값을 지정합니다. (다음에서 상속됨 Parameter)
Direction	Parameter 개체가 컨트롤에 값을 바인딩하는 데 사용되는지 또는 컨트롤을 사용하여 값을 변경할 수 있는지 여부를 나타냅니다. (다음에서 상속됨 Parameter)
IsTrackingViewState	Parameter 개체가 뷰 상태에 대한 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Parameter)
Name	매개 변수의 이름을 가져오거나 설정합니다. (다음에서 상속됨 Parameter)
QueryStringField	매개 변수가 바인딩하는 쿼리 문자열 필드의 이름을 가져오거나 설정합니다.
Size	매개 변수의 크기를 가져오거나 설정합니다. (다음에서 상속됨 Parameter)
Type	매개 변수의 형식을 가져오거나 설정합니다. (다음에서 상속됨 Parameter)
ValidateInput	쿼리 문자열 매개 변수의 값의 유효성을 검사할지 여부를 가져오거나 설정합니다.
ViewState	동일한 페이지에 대한 여러 요청에서 Parameter 개체의 뷰 상태를 저장하고 복원할 수 있는 상태 정보의 사전을 가져옵니다. (다음에서 상속됨 Parameter)

메서드

Clone()	현재 QueryStringParameter 인스턴스의 복제본을 반환합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
Evaluate(HttpContext, Control)	QueryStringParameter 개체의 값을 업데이트하고 반환합니다.
GetDatabaseType()	현재 Parameter 인스턴스의 CLR 형식과 동일한 DbType 값을 가져옵니다. (다음에서 상속됨 Parameter)
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
LoadViewState(Object)	데이터 원본 뷰의 이전에 저장된 뷰 상태를 복원합니다. (다음에서 상속됨 Parameter)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnParameterChanged()	Parameter 개체를 포함하는 ParameterCollection 컬렉션의 OnParametersChanged(EventArgs) 메서드를 호출합니다. (다음에서 상속됨 Parameter)
SaveViewState()	페이지가 서버에 다시 게시된 이후 Parameter 개체의 뷰 상태에 대한 변경 내용을 저장합니다. (다음에서 상속됨 Parameter)
SetDirty()	해당 상태가 뷰 상태에 기록되도록 Parameter 개체를 표시합니다. (다음에서 상속됨 Parameter)
ToString()	이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다. (다음에서 상속됨 Parameter)
TrackViewState()	Parameter 개체가 컨트롤의 ViewState 개체에 저장되고 동일한 페이지에 대한 요청 간에 유지될 수 있도록 뷰 상태에 대한 변경 내용을 추적하도록 합니다. (다음에서 상속됨 Parameter)

명시적 인터페이스 구현

ICloneable.Clone()	현재 Parameter 인스턴스의 복제본을 반환합니다. (다음에서 상속됨 Parameter)
IStateManager.IsTrackingViewState	Parameter 개체가 뷰 상태에 대한 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Parameter)
IStateManager.LoadViewState(Object)	데이터 원본 뷰의 이전에 저장된 뷰 상태를 복원합니다. (다음에서 상속됨 Parameter)
IStateManager.SaveViewState()	페이지가 서버에 다시 게시된 이후 Parameter 개체의 뷰 상태에 대한 변경 내용을 저장합니다. (다음에서 상속됨 Parameter)
IStateManager.TrackViewState()	Parameter 개체가 컨트롤의 ViewState 개체에 저장되고 동일한 페이지에 대한 요청 간에 유지될 수 있도록 뷰 상태에 대한 변경 내용을 추적하도록 합니다. (다음에서 상속됨 Parameter)

적용 대상

다음을 통해 공유

QueryStringParameter 클래스

정의

예제

설명

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

추가 정보

추가 리소스