SqlDataSourceMode 列挙型
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SqlDataSource コントロールまたは AccessDataSource コントロールの使用時に、データを IDataReader として取得するか、DataSet として取得するかを指定します。
public enum class SqlDataSourceModepublic enum SqlDataSourceModetype SqlDataSourceMode = Public Enum SqlDataSourceMode- 継承
| DataReader | 0 | 基になるデータ ストレージからデータを取得します IDataReader。 |
| DataSet | 1 | 基になるデータ ストレージから DataSet 構造体にデータを取得します。 |
次の例では、SQL Server データベースからコントロールにDataReader項目のSqlDataSource単純なリストを取得するときに、コントロールのプロパティを設定DataSourceModeする方法を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>
次の例では、並べ替えが有効になっているコントロールにDataSet一連のデータを取得するときにプロパティをGridView設定SqlDataSource.DataSourceModeする方法を示します。
<!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="DataSet"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
</asp:SqlDataSource>
<asp:GridView
id="GridView1"
runat="server"
AllowSorting="True"
DataSourceID="SqlDataSource1">
</asp:GridView>
</form>
</body>
</html>
<!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="DataSet"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
</asp:SqlDataSource>
<asp:GridView
id="GridView1"
runat="server"
AllowSorting="True"
DataSourceID="SqlDataSource1">
</asp:GridView>
</form>
</body>
</html>
列挙体はSqlDataSourceMode、メソッドがSqlDataSource呼び出されたときにSelectデータ ソース コントロールが使用するデータ取得モードを記述するために、コントロールによってAccessDataSource使用されます。 プロパティを DataSourceMode 設定 DataSetすると、データが構造体に読み込 DataSet まれます。 これにより、並べ替え機能やページング機能などの GridView ユーザー インターフェイス コントロールを制御するシナリオが可能になります。 プロパティが DataSourceMode 設定 DataReaderされている場合、データはオブジェクトによって IDataReader 取得されます。これは、読み取り専用の前方専用カーソルです。
列挙体は SqlDataSourceMode 、コマンドがデータを取得する方法を Select 記述するためにのみ使用されます。コントロールが実行する他の操作 SqlDataSource (例: Insert) Update、または Delete.
| 製品 | バージョン |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |