SqlDataSourceMode Enum
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menentukan apakah kontrol SqlDataSource atau AccessDataSource mengambil data sebagai IDataReader atau DataSet.
public enum class SqlDataSourceMode
public enum SqlDataSourceMode
type SqlDataSourceMode =
Public Enum SqlDataSourceMode
- Warisan
Bidang
| Nama | Nilai | Deskripsi |
|---|---|---|
| DataReader | 0 | Mengambil data dari penyimpanan data yang mendasar sebagai IDataReader. |
| DataSet | 1 | Mengambil data dari penyimpanan data yang mendasar ke dalam DataSet struktur. |
Contoh
Contoh berikut menunjukkan cara mengatur DataSourceMode properti kontrol ke DataReader saat mengambil daftar item sederhana dari database SQL Server ke dalam ListBoxSqlDataSource kontrol.
<%@ 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>
Contoh berikut menunjukkan cara mengatur properti ke SqlDataSource.DataSourceModeDataSet saat mengambil sekumpulan data ke dalam GridView kontrol yang telah mengaktifkan pengurutan.
<!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>
Keterangan
Enumerasi SqlDataSourceMode digunakan oleh SqlDataSource kontrol dan AccessDataSource untuk menjelaskan mode pengambilan data yang digunakan kontrol sumber data saat metode dipanggil Select .
DataSourceMode Ketika properti diatur ke DataSet, data dimuat ke dalam DataSet struktur. Ini memungkinkan skenario di mana kontrol antarmuka pengguna seperti GridView menawarkan kemampuan pengurutan dan penomoran halaman.
DataSourceMode Ketika properti diatur ke DataReader, data diambil oleh IDataReader objek, yang merupakan kursor baca-saja dan hanya-terusan.
Enumerasi SqlDataSourceMode hanya digunakan untuk menjelaskan bagaimana Select perintah mengambil data; tidak berpengaruh pada operasi lain yang SqlDataSource dilakukan kontrol, seperti Insert, , Updateatau Delete.