Exporter (0) Imprimer
Développer tout

SqlDataSource.DataSourceMode, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

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.

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

public SqlDataSourceMode DataSourceMode { get; set; }
/** @property */
public SqlDataSourceMode get_DataSourceMode ()

/** @property */
public void set_DataSourceMode (SqlDataSourceMode value)

public function get DataSourceMode () : SqlDataSourceMode

public function set DataSourceMode (value : SqlDataSourceMode)

Valeur de la propriété

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

Type d'exceptionCondition

ArgumentOutOfRangeException

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

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

Lorsque la propriété DataSourceMode a la valeur DataSet, les données sont chargées dans un objet DataSet et stockées dans la mémoire sur le serveur. Cela permet d'activer des scénarios où les contrôles de l'interface utilisateur, tels que GridView, offrent des fonctions de tri, de filtrage 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 avant uniquement en lecture seule. Le type spécifique de l'objet IDataReader dépend du fournisseur de données NET que SqlDataSource utilise, qui est identifié par la propriété ProviderName. Par défaut, le contrôle SqlDataSource utilise le fournisseur de Microsoft SQL Server, System.Data.SqlClient et le lecteur de données est un objet SqlDataReader.

Si vous modifiez la propriété DataSourceMode, l'événement DataSourceChanged est déclenché et tous les contrôles liés au SqlDataSource sont à nouveau liés.

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

L'exemple de code suivant illustre comment affecter la valeur DataReader à la propriété DataSourceMode du contrôle SqlDataSource pour un scénario avec un contrôle ListBox qui ne requiert pas de tri, ni de pagination ou de filtrage.

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

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
Afficher:
© 2014 Microsoft