Partage via

SqlDataSource.DataSourceMode Propriété

Définition

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

Obtient ou définit le mode de récupération de données utilisé par le SqlDataSource contrôle pour extraire des données.

public:
 property System::Web::UI::WebControls::SqlDataSourceMode DataSourceMode { System::Web::UI::WebControls::SqlDataSourceMode get(); void set(System::Web::UI::WebControls::SqlDataSourceMode value); };
public System.Web.UI.WebControls.SqlDataSourceMode DataSourceMode { get; set; }
member this.DataSourceMode : System.Web.UI.WebControls.SqlDataSourceMode with get, set
Public Property DataSourceMode As SqlDataSourceMode

Valeur de propriété

SqlDataSourceMode

Une des SqlDataSourceMode valeurs. La valeur par défaut est la DataSet valeur.

Exceptions

ArgumentOutOfRangeException

La DataSourceMode propriété n’est pas l’une des valeurs définies dans le SqlDataSourceMode.

Exemples

L’exemple de code suivant montre comment définir la DataSourceMode propriété du SqlDataSource contrôle sur la DataReader valeur d’un scénario avec un ListBox contrôle qui ne nécessite aucun tri, pagination ni filtrage.

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

Remarques

Le mode de récupération des données identifie comment un SqlDataSource contrôle récupère les données de la base de données sous-jacente.

Lorsque la DataSourceMode propriété est définie sur la DataSet valeur, les données sont chargées dans un DataSet objet et stockées en mémoire sur le serveur. Cela permet des scénarios où les contrôles d’interface utilisateur, tels que GridView, offrent des fonctionnalités de tri, de filtrage et de pagination.

Lorsque la DataSourceMode propriété est définie sur la DataReader valeur, les données sont récupérées par un IDataReader objet, qui est un curseur en lecture seule. Le type spécifique de l’objet IDataReader dépend du fournisseur de données NET utilisé par la SqlDataSourceProviderName propriété. Par défaut, le SqlDataSource contrôle utilise le fournisseur pour Microsoft SQL Server, le System.Data.SqlClientlecteur de données et le lecteur de données est un SqlDataReader objet.

Si vous modifiez la DataSourceMode propriété, l’événement DataSourceChanged est déclenché, ce qui provoque la liaison de tous les contrôles liés à la SqlDataSource liaison.

La valeur de la DataSourceMode propriété est stockée dans l’état d’affichage.

S’applique à

Voir aussi