ParameterCollection 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
public ref class ParameterCollection : System::Web::UI::StateManagedCollectionpublic class ParameterCollection : System.Web.UI.StateManagedCollectiontype ParameterCollection = class
inherit StateManagedCollectionPublic Class ParameterCollection
Inherits StateManagedCollection- 상속
예제
다음 코드 예제에 사용 하는 방법을 보여 줍니다.는 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, Insert를 Remove, 및 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 개체를 가져오거나 설정합니다. |
메서드
이벤트
| ParametersChanged |
컬렉션에 포함된 하나 이상의 Parameter 개체 상태가 바뀐 경우 발생합니다. |
명시적 인터페이스 구현
확장 메서드
| Cast<TResult>(IEnumerable) |
IEnumerable의 요소를 지정된 형식으로 캐스팅합니다. |
| OfType<TResult>(IEnumerable) |
지정된 형식에 따라 IEnumerable의 요소를 필터링합니다. |
| AsParallel(IEnumerable) |
쿼리를 병렬화할 수 있도록 합니다. |
| AsQueryable(IEnumerable) |
IEnumerable을 IQueryable로 변환합니다. |
적용 대상
추가 정보
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기