다음을 통해 공유


ParameterCollection 클래스

정의

고급 데이터 바인딩 시나리오의 데이터 소스 제어에서 사용하는 ParameterParameter파생 개체의 컬렉션을 나타냅니다.

public ref class ParameterCollection : System::Web::UI::StateManagedCollection
public class ParameterCollection : System.Web.UI.StateManagedCollection
type ParameterCollection = class
    inherit StateManagedCollection
Public Class ParameterCollection
Inherits StateManagedCollection
상속
ParameterCollection

예제

다음 코드 예제에 사용 하는 방법을 보여 줍니다.는 AccessDataSource 컨트롤 및 FormParameter Microsoft Access 데이터베이스에서 정보를 표시 하는 GridView 제어 합니다. 합니다 FormParameter 개체에 추가 됩니다 합니다 SelectParameters 사용 하 여 컬렉션을 Add 메서드.

중요

이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있으므로 보안상 위험할 수 있습니다. 기본적으로 ASP.NET 웹 페이지는 사용자 입력 내용에 스크립트 또는 HTML 요소가 포함되어 있지 않은지 확인합니다. 자세한 내용은 Script Exploits Overview를 참조하세요.

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

<script runat="server">

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname","LastNameBox");
  formParam.Type=TypeCode.String;
  AccessDataSource1.SelectParameters.Add(formParam);
}

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

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

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

<script runat="server">

Private Sub Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname","LastNameBox")
  formParam.Type=TypeCode.String
  AccessDataSource1.SelectParameters.Add(formParam)
End Sub ' Page_Load

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

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

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

설명

합니다 ParameterCollection 클래스의 컬렉션을 나타냅니다 Parameter 데이터 소스 컨트롤을 사용 하 여 고급 데이터 바인딩 시나리오에서 사용 되는 개체입니다. 합니다 Parameter 개체는 로컬에 포함 된 값을 바인딩하는 데 Page 변수, HTTP 쿠키, 세션 변수 및 다른 컨트롤의 값을 검색, 업데이트, 삭제 및 데이터를 삽입 하는 경우 데이터 소스 컨트롤입니다.

사용 된 ParameterCollection 집합을 프로그래밍 방식으로 관리 하는 클래스 Parameter 개체입니다. 추가, 삽입 및 제거 Parameter 의 적절 한 메서드를 사용 하 여 개체를 ParameterCollection 클래스입니다. 프로그래밍 방식으로 검색할 Parameter 개체 컬렉션에서 다음 방법 중 하나를 사용 합니다.

  • 인덱서를 사용 하 여 단일 가져옵니다 Parameter 이름 또는 배열 표기법을 사용 하 여 컬렉션에서 개체입니다.

  • 사용 하 여는 GetEnumerator 메서드를를 System.Collections.IEnumerator-컬렉션에서 항목을 가져오려면 다음 사용할 수 있는 구현된 개체입니다.

Count 속성 컬렉션에서 항목의 총 수를 지정 하 고 컬렉션의 상한을 결정 하는 데 사용 됩니다. 추가 사용 하 여 컬렉션에서 항목을 제거 합니다 Add, InsertRemove, 및 RemoveAt 메서드.

구현 하 고 특정 데이터 소스 컨트롤에 저장 되는 매개 변수 순서의 의미 체계에 따라는 ParameterCollection 컬렉션 중요할 수 있습니다. 예를 들어, 사용 하는 경우는 SqlDataSource 컨트롤의 순서는 ODBC 데이터 원본으로는 Parameter 개체는 ParameterCollection 컬렉션에서 사용 되는 매개 변수가 있는 SQL 쿼리를 매개 변수의 순서와 동일 해야 합니다. 그러나 사용 하는 경우는 SqlDataSource Microsoft SQL Server의 순서를 사용 하 여 컨트롤을 Parameter 개체는 중요 하지 않습니다.

중요

데이터 소스 컨트롤을 사용 하면 잠재적인 보안 위협 하는 유효성 검사 없이 명령 매개 변수에 값이 삽입 됩니다. 데이터 소스 컨트롤에서 명령이 실행 되기 전에 매개 변수 값의 유효성을 검사 하는 이벤트를 사용 합니다. 자세한 내용은 Script Exploits Overview를 참조하세요.

다음 표에서 다른 매개 변수 클래스 및 그 사용법을 나열 합니다.

매개 변수 클래스 Description
Parameter 기본 매개 변수 클래스입니다. 사용 하 여 사용 하 여 모든 고정 문자열 또는 지역 변수는 바인딩할는 DefaultValue 속성입니다.
ControlParameter 컨트롤의 속성 또는 메서드를 바인딩할 수 있는 매개 변수 값을 반환 합니다.
CookieParameter 쿠키의 값에 바인딩할 수 있는 매개 변수입니다.
FormParameter 현재 Web Forms 페이지의 특성을 바인딩할 수 있는 매개 변수입니다.
QueryStringParameter 쿼리 문자열에서 Web Forms 페이지에 전달 된 값에 바인딩할 수 있는 매개 변수입니다.
SessionParameter 세션 변수 값에 바인딩할 수 있는 매개 변수입니다.
ProfileParameter ASP.NET 프로필 속성의 값에 바인딩할 수 있는 매개 변수입니다.

생성자

ParameterCollection()

상속된 클래스 인스턴스에 사용할 수 있도록 클래스를 초기화합니다. 이 생성자는 상속된 클래스에서만 호출될 수 있습니다.

속성

Count

StateManagedCollection 컬렉션에 포함된 요소의 개수를 가져옵니다.

(다음에서 상속됨 StateManagedCollection)
Item[Int32]

컬렉션의 지정된 인덱스에 있는 Parameter 개체를 가져오거나 설정합니다.

Item[String]

컬렉션에서 지정된 이름을 가진 Parameter 개체를 가져오거나 설정합니다.

메서드

Add(Parameter)

지정된 Parameter 개체를 컬렉션의 끝에 추가합니다.

Add(String, DbType, String)

지정된 이름, 데이터베이스 형식 및 기본값을 사용하여 Parameter 개체를 만들고 컬렉션의 끝에 추가합니다.

Add(String, String)

지정된 이름과 기본값을 사용하여 Parameter 개체를 만들고 컬렉션의 끝에 추가합니다.

Add(String, TypeCode, String)

지정된 이름, Parameter 및 기본값을 사용하여 TypeCode 개체를 만들고 컬렉션의 끝에 추가합니다.

Clear()

StateManagedCollection 컬렉션에서 모든 항목을 제거합니다.

(다음에서 상속됨 StateManagedCollection)
Contains(Parameter)

ParameterCollection 컬렉션에 특정 값이 있는지 여부를 확인합니다.

CopyTo(Array, Int32)

특정 배열 인덱스부터 StateManagedCollection 컬렉션의 요소를 배열에 복사합니다.

(다음에서 상속됨 StateManagedCollection)
CopyTo(Parameter[], Int32)

매개 변수 배열의 지정된 인덱스를 매개 변수 컬렉션에 복사합니다.

CreateKnownType(Int32)

기본 Parameter 개체의 인스턴스를 만듭니다.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
GetEnumerator()

StateManagedCollection 컬렉션을 반복하는 반복기를 반환합니다.

(다음에서 상속됨 StateManagedCollection)
GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetKnownTypes()

Parameter 컬렉션에 포함될 수 있는 ParameterCollection 형식의 배열을 가져옵니다.

GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
GetValues(HttpContext, Control)

컬렉션에 현재 포함된 Parameter 개체 이름 및 해당 값의 순서 있는 컬렉션을 가져옵니다.

IndexOf(Parameter)

Parameter 컬렉션에서 지정된 ParameterCollection 개체의 인덱스를 확인합니다.

Insert(Int32, Parameter)

지정된 Parameter 개체를 ParameterCollection 컬렉션의 지정된 인덱스에 삽입합니다.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
OnClear()

파생 클래스에서 재정의된 경우 Clear() 메서드가 컬렉션에서 항목을 모두 제거하기 전에 추가 작업을 수행합니다.

(다음에서 상속됨 StateManagedCollection)
OnClearComplete()

컬렉션의 내용을 지운 후에 추가 사용자 지정 프로세스를 수행합니다.

OnInsert(Int32, Object)

Insert(Int32, Parameter) 메서드가 호출되기 전에 발생합니다.

OnInsertComplete(Int32, Object)

Insert(Int32, Parameter) 메서드가 완료된 후 발생합니다.

OnParametersChanged(EventArgs)

ParametersChanged 이벤트를 발생시킵니다.

OnRemove(Int32, Object)

파생 클래스에서 재정의된 경우 IList.Remove(Object) 또는 IList.RemoveAt(Int32) 메서드가 컬렉션에서 지정한 항목을 제거하기 전에 추가 작업을 수행합니다.

(다음에서 상속됨 StateManagedCollection)
OnRemoveComplete(Int32, Object)

Remove(Parameter) 메서드가 완료된 후 발생합니다.

OnValidate(Object)

값의 유효성을 검사할 때 추가로 사용자 지정 프로세스를 수행합니다.

Remove(Parameter)

Parameter 컬렉션에서 지정된 ParameterCollection 개체를 제거합니다.

RemoveAt(Int32)

Parameter 컬렉션에서 지정된 인덱스에 있는 ParameterCollection 개체를 제거합니다.

SetDirty()

전체 StateManagedCollection 컬렉션이 뷰 상태에 직렬화되도록 합니다.

(다음에서 상속됨 StateManagedCollection)
SetDirtyObject(Object)

지정된 Parameter 개체를 마지막으로 로드하거나 뷰 상태를 저장한 후에 이 개체가 변경된 것으로 표시합니다.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)
UpdateValues(HttpContext, Control)

컬렉션에 포함된 Parameter 개체에 대해 반복 작업을 수행하고 각 개체에 대해 Evaluate 메서드를 호출합니다.

이벤트

ParametersChanged

컬렉션에 포함된 하나 이상의 Parameter 개체 상태가 바뀐 경우 발생합니다.

명시적 인터페이스 구현

ICollection.Count

StateManagedCollection 컬렉션에 포함된 요소의 개수를 가져옵니다.

(다음에서 상속됨 StateManagedCollection)
ICollection.IsSynchronized

StateManagedCollection 컬렉션이 동기화되어 스레드로부터 안전하게 보호되는지 여부를 나타내는 값을 가져옵니다. 이 메서드는 항상 false를 반환합니다.

(다음에서 상속됨 StateManagedCollection)
ICollection.SyncRoot

StateManagedCollection 컬렉션에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다. 이 메서드는 항상 null를 반환합니다.

(다음에서 상속됨 StateManagedCollection)
IEnumerable.GetEnumerator()

StateManagedCollection 컬렉션을 반복하는 반복기를 반환합니다.

(다음에서 상속됨 StateManagedCollection)
IList.Add(Object)

StateManagedCollection 컬렉션에 항목을 추가합니다.

(다음에서 상속됨 StateManagedCollection)
IList.Clear()

StateManagedCollection 컬렉션에서 모든 항목을 제거합니다.

(다음에서 상속됨 StateManagedCollection)
IList.Contains(Object)

StateManagedCollection 컬렉션에 특정 값이 있는지 여부를 확인합니다.

(다음에서 상속됨 StateManagedCollection)
IList.IndexOf(Object)

StateManagedCollection 컬렉션에서 지정한 항목의 인덱스를 확인합니다.

(다음에서 상속됨 StateManagedCollection)
IList.Insert(Int32, Object)

항목을 StateManagedCollection 컬렉션 내의 지정한 인덱스에 삽입합니다.

(다음에서 상속됨 StateManagedCollection)
IList.IsFixedSize

StateManagedCollection 컬렉션의 크기가 고정되어 있는지 여부를 나타내는 값을 가져옵니다. 이 메서드는 항상 false를 반환합니다.

(다음에서 상속됨 StateManagedCollection)
IList.IsReadOnly

StateManagedCollection 컬렉션이 읽기 전용인지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 StateManagedCollection)
IList.Item[Int32]

지정된 인덱스에 있는 IStateManager 요소를 가져옵니다.

(다음에서 상속됨 StateManagedCollection)
IList.Remove(Object)

StateManagedCollection 컬렉션에서 맨 처음 발견되는 지정된 개체를 제거합니다.

(다음에서 상속됨 StateManagedCollection)
IList.RemoveAt(Int32)

지정한 인덱스에 있는 IStateManager 요소를 제거합니다.

(다음에서 상속됨 StateManagedCollection)
IStateManager.IsTrackingViewState

StateManagedCollection 컬렉션에서 해당 뷰 상태의 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 StateManagedCollection)
IStateManager.LoadViewState(Object)

이전에 저장된 StateManagedCollection 컬렉션과 이 컬렉션에 포함된 IStateManager 항목의 뷰 상태를 복원합니다.

(다음에서 상속됨 StateManagedCollection)
IStateManager.SaveViewState()

페이지가 서버에 포스트백된 이후에 발생한 StateManagedCollection 컬렉션과 이 컬렉션에 포함된 각 IStateManager 개체의 변경 내용을 저장합니다.

(다음에서 상속됨 StateManagedCollection)
IStateManager.TrackViewState()

StateManagedCollection 컬렉션과 이 컬렉션에 포함된 각 IStateManager 개체가 해당 뷰 상태의 변경 내용을 추적하여 같은 페이지에서 발생하는 여러 요청에 대해 유지할 수 있도록 합니다.

(다음에서 상속됨 StateManagedCollection)

확장 메서드

Cast<TResult>(IEnumerable)

IEnumerable의 요소를 지정된 형식으로 캐스팅합니다.

OfType<TResult>(IEnumerable)

지정된 형식에 따라 IEnumerable의 요소를 필터링합니다.

AsParallel(IEnumerable)

쿼리를 병렬화할 수 있도록 합니다.

AsQueryable(IEnumerable)

IEnumerableIQueryable로 변환합니다.

적용 대상

추가 정보