다음을 통해 공유


SessionParameter 클래스

정의

세션 변수의 값을 매개 변수 개체에 바인딩합니다.

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

예제

다음 예제에서는 개체를 사용하는 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 값을 사용하여 클래스의 새 인스턴스를 original 초기화합니다.

SessionParameter(String, DbType, String)

지정된 이름과 형식을 사용하여 클래스의 SessionParameter 새 인스턴스를 초기화하고 매개 변수를 지정된 세션 상태 이름/값 쌍에 바인딩합니다. 이 생성자는 데이터베이스 형식을 위한 것입니다.

SessionParameter(String, String)

지정된 문자열을 사용하여 바인딩할 세션 상태 이름/값 쌍을 식별하여 클래스의 SessionParameter 명명된 새 인스턴스를 초기화합니다.

SessionParameter(String, TypeCode, String)

지정된 문자열을 사용하여 바인딩할 세션 상태 이름/값 쌍을 식별하여 클래스의 명명되고 강력한 형식의 SessionParameter 새 인스턴스를 초기화합니다.

속성

Name Description
ConvertEmptyStringToNull

개체가 바인딩된 값을 변환할지 nullEmpty여부를 나타내는 값을 Parameter 가져오거나 설정합니다.

(다음에서 상속됨 Parameter)
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)

적용 대상

추가 정보