SqlDataSourceMode Enum

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Anger om en SqlDataSource kontroll AccessDataSource hämtar data som en IDataReader eller DataSet.

public enum class SqlDataSourceMode
public enum SqlDataSourceMode
type SqlDataSourceMode = 
Public Enum SqlDataSourceMode
Arv
Object
ValueType
Enum
SqlDataSourceMode

Fält

Name Värde Description
DataReader 0

Hämtar data från den underliggande datalagringen som en IDataReader.
DataSet 1

Hämtar data från den underliggande datalagringen till en DataSet struktur.

Exempel

I följande exempel visas hur du anger egenskapen DataSourceMode för en SqlDataSource-kontroll till DataReader när du hämtar en enkel lista över objekt från en SQL Server databas till en ListBox-kontroll.

<%@ 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>

I följande exempel visas hur du anger SqlDataSource.DataSourceMode egenskapen till DataSet när du hämtar en uppsättning data till en GridView kontroll som har sortering aktiverat.

<!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>

Kommentarer

Uppräkningen SqlDataSourceMode används av SqlDataSource kontrollerna och AccessDataSource för att beskriva det datahämtningsläge som datakällans kontroll använder när Select metoden anropas. När egenskapen DataSourceMode är inställd DataSetpå läses data in i en DataSet struktur. Detta möjliggör scenarier där användargränssnittskontroller som GridView erbjuder sorterings- och växlingsfunktioner. När egenskapen DataSourceMode är inställd DataReaderpå hämtas data av ett IDataReader objekt, som är en skrivskyddad, framåtriktad markör.

Uppräkningen SqlDataSourceMode används bara för att beskriva hur Select kommandot hämtar data. Det har ingen effekt på andra åtgärder SqlDataSource som kontrollen utför, till exempel Insert, Updateeller Delete.

Gäller för

Se även