SqlDataSource.DataSourceMode Propriété

  • Référence

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 que le contrôle SqlDataSource utilise pour récupérer les 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 valeurs de l'objet SqlDataSourceMode. La valeur par défaut est la valeur DataSet.

Exceptions

ArgumentOutOfRangeException

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

Exemples

L’exemple de code suivant montre comment définir la DataSourceMode propriété du contrôle sur la DataReaderSqlDataSource valeur d’un scénario avec un ListBox contrôle qui ne nécessite aucun tri, pagination ou 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 la façon dont 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 valeur, les DataSet 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 valeur, les DataReader 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 ProviderName la SqlDataSource propriété . Par défaut, le SqlDataSource contrôle utilise le fournisseur pour Microsoft SQL Server, et System.Data.SqlClientle lecteur de données est un SqlDataReader objet.

Si vous modifiez la DataSourceMode propriété, l’événement DataSourceChanged est déclenché, ce qui entraîne la reliure de tous les contrôles liés au SqlDataSource .

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

S’applique à

Voir aussi