SqlDataSource.DataSourceMode Propriété

Définition

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.Gets or sets the data retrieval mode that the SqlDataSource control uses to fetch data.

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.One of the SqlDataSourceMode values. La valeur par défaut est la DataSet valeur.The default is the DataSet value.

Exceptions

La propriété DataSourceMode n'est pas l'une des valeurs définies dans SqlDataSourceMode.The DataSourceMode property is not one of the values defined in the SqlDataSourceMode.

Exemples

L’exemple de code suivant montre comment affecter à la DataSourceMode propriété du SqlDataSource contrôle la DataReader valeur d’un scénario avec un ListBox contrôle ne nécessitant pas de tri, de pagination ou de filtrage.The following code example demonstrates how to set the DataSourceMode property of the SqlDataSource control to the DataReader value for a scenario with a ListBox control that requires no sorting, paging, nor filtering.

<%@ 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 manière dont un SqlDataSource contrôle récupère les données de la base de données sous-jacente.The data retrieval mode identifies how a SqlDataSource control retrieves data from the underlying database.

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.When the DataSourceMode property is set to the DataSet value, data is loaded into a DataSet object and stored in memory on the server. Cela permet des scénarios dans lesquels les contrôles d’interface utilisateur, tels que GridView , offrent des fonctionnalités de tri, de filtrage et de pagination.This enables scenarios where user interface controls, such as GridView, offer sorting, filtering, and paging capabilities.

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 avant uniquement en lecture seule.When the DataSourceMode property is set to the DataReader value, data is retrieved by a IDataReader object, which is a forward-only, read-only cursor. Le type spécifique de l' IDataReader objet dépend du fournisseur de données net utilisé SqlDataSource par le, qui est identifié par la ProviderName propriété.The specific type of the IDataReader object depends on the NET data provider that the SqlDataSource uses, which is identified by the ProviderName property. Par défaut, le SqlDataSource contrôle utilise le fournisseur pour Microsoft SQL Server, System.Data.SqlClient et le lecteur de données est un SqlDataReader objet.By default, the SqlDataSource control uses the provider for Microsoft SQL Server, the System.Data.SqlClient, and the data reader is a SqlDataReader object.

Si vous modifiez la DataSourceMode propriété, l' DataSourceChanged événement est déclenché, ce qui entraîne la reliaison de tous les contrôles liés au SqlDataSource .If you change the DataSourceMode property, the DataSourceChanged event is raised, causing any controls that are bound to the SqlDataSource to rebind.

La valeur de la DataSourceMode propriété est stockée dans l’état d’affichage.The value of the DataSourceMode property is stored in view state.

S’applique à

Voir aussi