Exporter (0) Imprimer
Développer tout
Développer Réduire

SqlDataSourceMode, énumération

Remarque : cette énumération est nouvelle dans le .NET Framework version 2.0.

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

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public enum SqlDataSourceMode
public enum SqlDataSourceMode
public enum SqlDataSourceMode

 Nom de membreDescription
DataReaderRécupère des données du stockage de données sous-jacent comme un IDataReader 
DataSetRécupère des données du stockage de données sous-jacent dans une structure DataSet

L'énumération SqlDataSourceMode est utilisée par les contrôles SqlDataSource et AccessDataSource pour décrire le mode de récupération de données que le contrôle de source de données utilise lorsque la méthode Select est appelée. Lorsque la propriété DataSourceMode a la valeur DataSet, les données sont chargées dans une structure DataSet. Cela active des scénarios dans lesquels les contrôles d'interface utilisateur tels que GridView offrent des fonctions de tri et de pagination. Lorsque la propriété DataSourceMode a la valeur DataReader, les données sont récupérées par un objet IDataReader qui est un curseur en lecture seule et avant uniquement.

L'énumération SqlDataSourceMode est utilisée uniquement pour décrire la manière dont la commande Select récupère des données ; elle n'a aucun effet sur les autres opérations que le contrôle SqlDataSource exécute, telles que Insert, Update ou Delete.

L'exemple de code suivant montre comment attribuer la valeur DataSourceMode au SqlDataSource d'un contrôle lors de la récupération d'une simple liste d'éléments d'une base de données SQL Server dans un contrôle ListBox.

<%@ Page language="CS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM 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>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

    </FORM>
  </BODY>
</HTML>

L'exemple de code suivant montre comment attribuer la valeur DataSet au DataSourceMode lors de la récupération d'un groupe de données dans un contrôle GridView pour lequel le tri est activé.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM 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>
  <BODY>
    <FORM runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </FORM>
  </BODY>
</HTML>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft