SqlDataSource.DataSourceMode プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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, setPublic Property DataSourceMode As SqlDataSourceModeプロパティ値
SqlDataSourceMode 値のいずれか 1 つ。 既定値は、DataSet です。
例外
DataSourceMode プロパティが SqlDataSourceMode に定義されている値ではありません。
例
次のコード例では、並べ替え、ページング、フィルター処理を必要としないコントロールDataReaderを使用ListBoxするシナリオで、 コントロールの プロパティSqlDataSourceを 値に設定DataSourceModeする方法を示します。
<%@ 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 NET データ プロバイダーによって異なります。これは、 プロパティによって ProviderName 識別されます。 既定では、コントロールは SqlDataSource Microsoft SQL Server のプロバイダー を System.Data.SqlClient使用し、データ リーダーは オブジェクトです SqlDataReader 。
プロパティを DataSourceMode 変更すると、 DataSourceChanged イベントが発生し、 に SqlDataSource バインドされているコントロールが再バインドされます。
プロパティの DataSourceMode 値はビューステートに格納されます。
適用対象
こちらもご覧ください
.NET