SessionParameter 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
세션 변수의 값을 매개 변수 개체에 바인딩합니다.
public ref class SessionParameter : System::Web::UI::WebControls::Parameter
public class SessionParameter : System.Web.UI.WebControls.Parameter
type SessionParameter = class
inherit Parameter
Public Class SessionParameter
Inherits Parameter
- 상속
예제
다음 예제에서는 개체를 사용하는 SessionParameter 방법을 보여줍니다. 이 예제에서는 다른 페이지에서 직원 ID 값을 세션 변수에 저장한 것으로 empid가정합니다. 예제 페이지는 쿼리 절의 세션 변수 Where 를 사용하고 empid 쿼리 결과를 컨트롤에 GridView 표시합니다.
DefaultValue 개체의 SessionParameter 속성이 5로 설정되므로 예제를 실행하기 전에 명명 empid 된 세션 변수가 employeeID 설정되지 않은 경우에도 값이 5인 레코드의 데이터가 계속 표시됩니다.
<%@ 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">
<p>Show My Orders:</p>
<asp:SqlDataSource
id="OdbcDataSource1"
runat="server"
ProviderName="System.Data.Odbc"
ConnectionString="dsn=MyOdbcDsn;"
SelectCommand="SELECT OrderId, CustomerId, OrderDate
FROM Orders
WHERE EmployeeID = ?
ORDER BY CustomerId ASC;">
<SelectParameters>
<asp:SessionParameter
Name="empid"
SessionField="empid"
DefaultValue="5" />
</SelectParameters>
</asp:SqlDataSource>
<p>
<asp:GridView
id="GridView1"
runat="server"
DataSourceID="OdbcDataSource1" />
</p>
</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">
<p>Show My Orders:</p>
<asp:SqlDataSource
id="OdbcDataSource1"
runat="server"
ProviderName="System.Data.Odbc"
ConnectionString="dsn=MyOdbcDsn;"
SelectCommand="SELECT OrderId, CustomerId, OrderDate
FROM Orders
WHERE EmployeeID = ?
ORDER BY CustomerId ASC;">
<SelectParameters>
<asp:SessionParameter
Name="empid"
SessionField="empid"
DefaultValue="5" />
</SelectParameters>
</asp:SqlDataSource>
<p>
<asp:GridView
id="GridView1"
runat="server"
DataSourceID="OdbcDataSource1" />
</p>
</form>
</body>
</html>
설명
SessionParameter 개체는 일반적으로 데이터베이스 쿼리 절에 변수 Where 값을 HttpSessionState 포함하기 위해 사용됩니다. 이 속성은 SessionField 값을 검색하는 SessionParameter 세션 변수를 식별합니다.
메모
지정된 세션 변수가 설정되지 않은 경우 개체를 사용하여 SessionParameter 매개 변수에 데이터를 바인딩하는 컨트롤이 예외를 throw할 수 있습니다. 이 오류를 방지하려면(해당하는 경우) 속성을 설정합니다 DefaultValue .
생성자
| Name | Description |
|---|---|
| SessionParameter() |
클래스의 명명되지 않은 새 인스턴스를 초기화합니다 SessionParameter . |
| SessionParameter(SessionParameter) |
매개 변수로 지정된 인스턴스의 SessionParameter 값을 사용하여 클래스의 새 인스턴스를 |
| SessionParameter(String, DbType, String) |
지정된 이름과 형식을 사용하여 클래스의 SessionParameter 새 인스턴스를 초기화하고 매개 변수를 지정된 세션 상태 이름/값 쌍에 바인딩합니다. 이 생성자는 데이터베이스 형식을 위한 것입니다. |
| SessionParameter(String, String) |
지정된 문자열을 사용하여 바인딩할 세션 상태 이름/값 쌍을 식별하여 클래스의 SessionParameter 명명된 새 인스턴스를 초기화합니다. |
| SessionParameter(String, TypeCode, String) |
지정된 문자열을 사용하여 바인딩할 세션 상태 이름/값 쌍을 식별하여 클래스의 명명되고 강력한 형식의 SessionParameter 새 인스턴스를 초기화합니다. |
속성
| Name | Description |
|---|---|
| ConvertEmptyStringToNull |
개체가 바인딩된 값을 변환할지 |
| DbType |
매개 변수의 데이터베이스 형식을 가져오거나 설정합니다. (다음에서 상속됨 Parameter) |
| DefaultValue |
메서드가 호출될 때 매개 변수가 초기화되지 않을 바인딩된 값인 경우 매개 변수의 기본값을 Evaluate(HttpContext, Control) 지정합니다. (다음에서 상속됨 Parameter) |
| Direction |
개체가 컨트롤에 Parameter 값을 바인딩하는 데 사용되는지 또는 컨트롤을 사용하여 값을 변경할 수 있는지 여부를 나타냅니다. (다음에서 상속됨 Parameter) |
| IsTrackingViewState |
개체가 뷰 상태에 대한 변경 내용을 저장하고 있는지 여부를 Parameter 나타내는 값을 가져옵니다. (다음에서 상속됨 Parameter) |
| Name |
매개 변수의 이름을 가져오거나 설정합니다. (다음에서 상속됨 Parameter) |
| SessionField |
매개 변수가 바인딩하는 세션 변수의 이름을 가져오거나 설정합니다. |
| Size |
매개 변수의 크기를 가져오거나 설정합니다. (다음에서 상속됨 Parameter) |
| Type |
매개 변수의 형식을 가져오거나 설정합니다. (다음에서 상속됨 Parameter) |
| ViewState |
동일한 페이지에 대한 여러 요청에서 개체의 Parameter 뷰 상태를 저장하고 복원할 수 있는 상태 정보 사전을 가져옵니다. (다음에서 상속됨 Parameter) |
메서드
| Name | Description |
|---|---|
| Clone() |
현재 SessionParameter 인스턴스의 중복을 반환합니다. |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object) |
| Evaluate(HttpContext, Control) |
개체의 SessionParameter 값을 업데이트하고 반환합니다. |
| GetDatabaseType() |
현재 Parameter 인스턴스의 DbType CLR 형식과 동일한 값을 가져옵니다. (다음에서 상속됨 Parameter) |
| GetHashCode() |
기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object) |
| GetType() |
현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object) |
| LoadViewState(Object) |
데이터 원본 뷰의 이전에 저장된 뷰 상태를 복원합니다. (다음에서 상속됨 Parameter) |
| MemberwiseClone() |
현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| OnParameterChanged() |
개체를 OnParametersChanged(EventArgs) 포함하는 컬렉션의 ParameterCollection 메서드를 Parameter 호출합니다. (다음에서 상속됨 Parameter) |
| SaveViewState() |
페이지가 서버에 다시 게시된 이후 개체의 뷰 상태에 대한 변경 내용을 Parameter 저장합니다. (다음에서 상속됨 Parameter) |
| SetDirty() |
개체의 Parameter 상태가 뷰 상태에 기록되도록 개체를 표시합니다. (다음에서 상속됨 Parameter) |
| ToString() |
이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다. (다음에서 상속됨 Parameter) |
| TrackViewState() |
개체가 Parameter 컨트롤의 ViewState 개체에 저장되고 동일한 페이지에 대한 요청 간에 유지될 수 있도록 개체가 뷰 상태에 대한 변경 내용을 추적하도록 합니다. (다음에서 상속됨 Parameter) |
명시적 인터페이스 구현
| Name | Description |
|---|---|
| ICloneable.Clone() |
현재 Parameter 인스턴스의 중복을 반환합니다. (다음에서 상속됨 Parameter) |
| IStateManager.IsTrackingViewState |
개체가 뷰 상태에 대한 변경 내용을 저장하고 있는지 여부를 Parameter 나타내는 값을 가져옵니다. (다음에서 상속됨 Parameter) |
| IStateManager.LoadViewState(Object) |
데이터 원본 뷰의 이전에 저장된 뷰 상태를 복원합니다. (다음에서 상속됨 Parameter) |
| IStateManager.SaveViewState() |
페이지가 서버에 다시 게시된 이후 개체의 뷰 상태에 대한 변경 내용을 Parameter 저장합니다. (다음에서 상속됨 Parameter) |
| IStateManager.TrackViewState() |
개체가 Parameter 컨트롤의 ViewState 개체에 저장되고 동일한 페이지에 대한 요청 간에 유지될 수 있도록 개체가 뷰 상태에 대한 변경 내용을 추적하도록 합니다. (다음에서 상속됨 Parameter) |