SqlDataSource.DataSourceMode 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

SqlDataSource 컨트롤에서 데이터를 페치하는 데 사용할 데이터 검색 모드를 가져오거나 설정합니다.

public:
 property System::Web::UI::WebControls::SqlDataSourceMode DataSourceMode { System::Web::UI::WebControls::SqlDataSourceMode get(); void set(System::Web::UI::WebControls::SqlDataSourceMode value); };
public System.Web.UI.WebControls.SqlDataSourceMode DataSourceMode { get; set; }
member this.DataSourceMode : System.Web.UI.WebControls.SqlDataSourceMode with get, set
Public Property DataSourceMode As SqlDataSourceMode

속성 값

SqlDataSourceMode

SqlDataSourceMode 값 중 하나입니다. 기본값은 DataSet 값입니다.

예외

ArgumentOutOfRangeException

DataSourceMode 속성이 SqlDataSourceMode에 정의된 값 중 하나가 아닌 경우

예제

다음 코드 예제에는 설정 하는 방법을 보여 줍니다.를 DataSourceMode 의 속성을 SqlDataSource 컨트롤을 DataReader 사용 하는 시나리오에 대 한 값을 ListBox 없습니다 정렬 해야 하는 컨트롤, 페이징, 필터링 또는.

<%@ 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" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

    </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" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

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

설명

데이터 검색 모드를 식별 하는 방법을 SqlDataSource 컨트롤 기본 데이터베이스에서 데이터를 검색 합니다.

때를 DataSourceMode 속성을 DataSet 값 데이터가 로드 되는 DataSet 개체 및 서버에서 메모리에 저장 된. 이 시나리오와 같은 사용자 인터페이스 컨트롤 위치를 통해 GridView, 정렬, 필터링 및 페이징 기능을 제공 합니다.

때를 DataSourceMode 속성을 DataReader 값 데이터를 검색 하는 IDataReader 개체는 읽기 전용, 정방향 전용 커서는. 특정 유형의 합니다 IDataReader 개체 순 데이터 공급자에 따라 달라 집니다는 SqlDataSource 식별 되는 사용 하 여는 ProviderName 속성. 기본적으로 SqlDataSource 컨트롤은 Microsoft SQL Server에 대 한 공급자를 사용 합니다 System.Data.SqlClient, 데이터 판독기가 및는 SqlDataReader 개체.

변경 하는 경우는 DataSourceMode 속성을 DataSourceChanged 이벤트가 발생에 바인딩되는 컨트롤을 SqlDataSource 바인딩할.

값을 DataSourceMode 속성은 뷰 상태에 저장 됩니다.

적용 대상

추가 정보