SqlDataSourceMode Énumération

Définition

Spécifie si un contrôle SqlDataSource ou AccessDataSource récupère des données comme un IDataReader ou un DataSet.

public enum class SqlDataSourceMode
public enum SqlDataSourceMode
type SqlDataSourceMode = 
Public Enum SqlDataSourceMode
Héritage
SqlDataSourceMode

Champs

DataReader 0

Récupère des données du stockage de données sous-jacent en tant que IDataReader.

DataSet 1

Récupère des données du stockage de données sous-jacent dans une structure DataSet.

Exemples

L’exemple suivant montre comment définir la DataSourceMode propriété d’un SqlDataSource contrôle sur DataReader lors de la récupération d’une liste simple d’éléments d’une base de données SQL Server dans un ListBox contrôle.

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

L’exemple suivant montre comment définir la propriété sur DataSet lors de la récupération d’un jeu de données dans un GridView contrôle pour lequel le SqlDataSource.DataSourceMode tri est activé.

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

Remarques

L’énumération SqlDataSourceMode est utilisée par les SqlDataSource contrôles et AccessDataSource pour décrire le mode de récupération des données utilisé par le contrôle de source de données lorsque la Select méthode est appelée. Lorsque la propriété a la DataSourceModeDataSetvaleur , les données sont chargées dans une DataSet structure. Cela permet des scénarios où des contrôles d’interface utilisateur tels que GridView des fonctionnalités de tri et de pagination sont disponibles. Lorsque la propriété a la DataSourceModeDataReadervaleur , les données sont récupérées par un IDataReader objet, qui est un curseur en lecture seule, avant uniquement.

L’énumération SqlDataSourceMode est utilisée uniquement pour décrire la façon dont la Select commande récupère les données ; elle n’a aucun effet sur les autres opérations effectuées par le SqlDataSource contrôle, telles que Insert, Updateou Delete.

S’applique à

Voir aussi