Partager via

SqlDataSourceMode Énumération

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

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

Champs

Nom Valeur Description
DataReader 0

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

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

Exemples

L’exemple suivant montre comment définir la DataSourceMode propriété d’un SqlDataSource contrôle 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é DataSet lors de la récupération d’un jeu de données dans un GridView contrôle sur 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 pour AccessDataSource décrire le mode de récupération de données utilisé par le contrôle de source de données lorsque la Select méthode est appelée. Lorsque la propriété est définie DataSetsur , les DataSourceMode données sont chargées dans une DataSet structure. Cela permet des scénarios dans lesquels les contrôles d’interface utilisateur, tels que GridView le tri et les fonctionnalités de pagination, sont proposés. Lorsque la propriété est définie DataReadersur , les DataSourceMode données sont récupérées par un IDataReader objet, qui est un curseur en lecture seule et en 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 d’autres opérations effectuées par le SqlDataSource contrôle, telles que Insert, Updateou Delete.

S’applique à

Voir aussi