SqlDataSourceMode 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
指定 SqlDataSource 或 AccessDataSource 控制項取資料做為 IDataReader 或 DataSet。
public enum class SqlDataSourceMode
public enum SqlDataSourceMode
type SqlDataSourceMode =
Public Enum SqlDataSourceMode
- 繼承
欄位
名稱 | 值 | Description |
---|---|---|
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>
下列範例示範如何在將一組資料擷取至 GridView 已啟用排序的控制項時,將 屬性 DataSet
設定 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
AccessDataSource 控制項會使用 SqlDataSource 列舉來描述呼叫 方法時 Select 資料來源控制項所使用的資料擷取模式。
DataSourceMode當 屬性設定為 DataSet
時,資料會載入結構 DataSet 中。 這會啟用使用者介面控制項的案例,例如 GridView 提供排序和分頁功能。
DataSourceMode當 屬性設定為 DataReader
時,物件會擷 IDataReader 取資料,這是唯讀的順向資料指標。
SqlDataSourceMode
列舉只會用來描述命令擷取資料的方式 Select ;它不會影響控制項執行的其他作業 SqlDataSource ,例如 Insert 、 Update 或 Delete 。