LinqDataSource Classe

Définition

public ref class LinqDataSource : System::Web::UI::DataSourceControl, System::Web::DynamicData::IDynamicDataSource

public ref class LinqDataSource : System::Web::UI::WebControls::ContextDataSource, System::Web::DynamicData::IDynamicDataSource

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")]
public class LinqDataSource : System.Web.UI.DataSourceControl, System.Web.DynamicData.IDynamicDataSource

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")]
public class LinqDataSource : System.Web.UI.WebControls.ContextDataSource, System.Web.DynamicData.IDynamicDataSource

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")>]
type LinqDataSource = class
    inherit DataSourceControl
    interface IDynamicDataSource
    interface IDataSource

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")>]
type LinqDataSource = class
    inherit ContextDataSource
    interface IDynamicDataSource
    interface IDataSource

Public Class LinqDataSource
Inherits DataSourceControl
Implements IDynamicDataSource

Public Class LinqDataSource
Inherits ContextDataSource
Implements IDynamicDataSource

Héritage

Object

Control

DataSourceControl

LinqDataSource

Héritage

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

Attributs

ToolboxBitmapAttribute

Implémente

IDynamicDataSource IDataSource

Exemples

L’exemple suivant montre un LinqDataSource contrôle qui récupère les données d’une classe d’entité nommée Products. La classe d’entité peut avoir été générée à l’aide du Concepteur O/R ou de l’utilitaire de SqlMetal.exe. La Where propriété est définie pour renvoyer uniquement les enregistrements dont la valeur est supérieure à 50 dans la Price propriété. Un GridView contrôle est lié au LinqDataSource contrôle pour afficher les données.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

L’exemple suivant montre un LinqDataSource contrôle qui permet aux utilisateurs de mettre à jour, supprimer et insérer des enregistrements dans la source de données. Un DetailsView contrôle est lié au LinqDataSource contrôle et permet aux utilisateurs d’afficher et de modifier les données. Notez qu’aucune commande SQL n’est requise pour sélectionner, mettre à jour, supprimer ou insérer les enregistrements.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

L’exemple suivant montre un gestionnaire d’événements pour l’événement Selecting qui définit l’objet de données en fonction d’une valeur dans la page Web.

public partial class Default3 : System.Web.UI.Page
{
    string[] citiesArray = 
    { 
        "Atlanta", 
        "Charlotte", 
        "Denver", 
        "New York", 
        "San Francisco" 
    };

    protected void Page_Load(object sender, EventArgs e)
    {
    }

    protected void LinqDataSource_Selecting(object sender, LinqDataSourceSelectEventArgs e)
    {
        var cities = from city in citiesArray
                     where city.CompareTo("B") > 0
                     select city;
        e.Result = cities;
        // Or we could set e.Result = citiesArray to return all rows.
    }
}

Partial Class Default3
    Inherits System.Web.UI.Page

    Dim citiesArray() As String = _
    { _
        "Atlanta", _
        "Charlotte", _
        "Denver", _
        "New York", _
        "San Francisco" _
    }


    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
       
    End Sub

    
    Protected Sub LinqDataSource_Selecting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceSelectEventArgs) Handles LinqDataSource1.Selecting
        Dim cities = From city In citiesArray _
                     Where city > "B" _
                     Select city
        e.Result = cities
        ' Or we could set e.Result = citiesArray to return all rows.
    End Sub
    
End Class

L’exemple suivant montre un LinqDataSource contrôle configuré pour regrouper par deux colonnes. La Key propriété fait référence à un objet qui a deux propriétés et ProductCategoryColor. L’objet représenté par It est renommé (alias) en Products. L’objet renommé Products contient une collection d’enregistrements individuels dans un regroupement. Chaque instance contient toutes les colonnes de la Products table.

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

L’exemple suivant montre deux ListView contrôles qui affichent les données du LinqDataSource contrôle dans l’exemple précédent. Un ListView contrôle affiche les données groupées, et l’autre ListView contrôle affiche les noms individuels des produits appartenant à ce groupe. La propriété du DataSource contrôle imbriqué lié aux données est définie Productssur , qui est l’alias de l’objet It .

<asp:ListView 
    DataSourceID="LinqDataSource1" 
    ID="ListView1" runat="server">

    <LayoutTemplate>
      <table id="Table1" 
          style="background-color:Teal;color:White" 
          runat="server" 
          class="Layout">
          
        <thead>
          <tr>
            <th><b>Product Category</b></th>
            <th><b>Color</b></th>
            <th><b>Highest Price</b></th>
            <th><b>Lowest Price</b></th>
          </tr>
        </thead>
        <tr runat="server" id="itemPlaceholder">
        </tr>
        
      </table>
    </LayoutTemplate>

    <ItemTemplate>
      <tr>
        <td><%# Eval("key.ProductCategory") %></td>
        <td><%# Eval("key.Color") %></td>
        <td><%# Eval("MaxListPrice") %></td>
        <td><%# Eval("MinListPrice") %></td>
      </tr>
      <tr>
        
        <td colspan="4" style="width:100%;background-color:White;color:Black">
          <asp:ListView 
            DataSource='<%# Eval("Products") %>' 
            runat="server" 
            ID="ListView2">

            <LayoutTemplate>
              <div runat="server" id="itemPlaceholder" />
            </LayoutTemplate>

            <ItemTemplate>
              <%# Eval("ProductName") %><br />
            </ItemTemplate>

          </asp:ListView> 
        </td>
      </tr>
    </ItemTemplate>
  </asp:ListView>

<asp:ListView 
   DataSourceID="LinqDataSource1" 
   ID="ListView1" runat="server">

   <LayoutTemplate>
     <table id="Table1" 
         style="background-color:Teal;color:White" 
         runat="server" 
         class="Layout">
         
       <thead>
         <tr>
           <th><b>Product Category</b></th>
           <th><b>Color</b></th>
           <th><b>Highest Price</b></th>
           <th><b>Lowest Price</b></th>
         </tr>
       </thead>
       <tr runat="server" id="itemPlaceholder">
       </tr>
       
     </table>
   </LayoutTemplate>

   <ItemTemplate>
     <tr>
       <td><%# Eval("key.ProductCategory") %></td>
       <td><%# Eval("key.Color") %></td>
       <td><%# Eval("MaxListPrice") %></td>
       <td><%# Eval("MinListPrice") %></td>
     </tr>
     <tr>
       
       <td colspan="4" style="width:100%;background-color:White;color:Black">
         <asp:ListView 
           DataSource='<%# Eval("Products") %>' 
           runat="server" 
           ID="ListView2">

           <LayoutTemplate>
             <div runat="server" id="itemPlaceholder" />
           </LayoutTemplate>

           <ItemTemplate>
             <%# Eval("ProductName") %><br />
           </ItemTemplate>

         </asp:ListView> 
       </td>
     </tr>
   </ItemTemplate>
 </asp:ListView>

Remarques

Dans cette rubrique :

• Introduction

• Ordre des opérations

• Classement des données

• Regroupement de données

• Modifications des données

• Évaluation des valeurs au moment de l’exécution

• Utilisation des procédures stockées

• Syntaxe déclarative

Présentation

Language-Integrated Query (LINQ) est une syntaxe de requête qui définit un ensemble d’opérateurs de requête qui permettent aux opérations de traversée, de filtre et de projection d’être exprimées de manière déclarative. Langage de programmation BASÉ sur NET. L’objet de données peut être une collection de données en mémoire ou un objet qui représente des données d’une base de données. Vous pouvez récupérer ou modifier les données sans avoir à écrire des commandes SQL pour chaque opération.

Le LinqDataSource contrôle vous permet d’utiliser LINQ dans une page web ASP.NET en définissant des propriétés dans le texte de balisage. Le LinqDataSource contrôle utilise LINQ to SQL pour générer automatiquement les commandes de données. Pour plus d’informations sur LINQ to SQL, consultez LINQ to SQL.

Lorsque vous récupérez des données à partir d’une collection de données en mémoire, vous définissez la ContextTypeName propriété sur la classe qui contient la collection de données. Vous définissez la propriété sur la propriété ou le TableName champ qui retourne la collection de données. Par exemple, vous pouvez avoir une classe nommée Person qui contient une propriété nommée FavoriteCities qui retourne un tableau de valeurs de chaîne. Dans ce cas, vous définissez la ContextTypeName propriété sur Person et définissez la propriété sur TableNameFavoriteCities.

Lorsque vous interrogez une base de données, vous devez d’abord créer des classes d’entité qui représentent la base de données et ses tables. Vous pouvez utiliser le Concepteur relationnel objet ou l’utilitaire de SqlMetal.exe pour générer ces classes. Vous définissez ensuite la ContextTypeName propriété sur la classe qui représente la base de données et définissez la TableName propriété sur la propriété qui représente la table de base de données.

Ordre des opérations

Le LinqDataSource contrôle applique les opérations de données dans l’ordre suivant :

1. Où (spécifier les enregistrements de données à retourner).

2. Ordre par (tri).

3. Regrouper par (agréger les enregistrements de données qui partagent des valeurs).

4. Triez les groupes par (triez les données groupées).

5. Sélectionnez (spécifiez les champs ou propriétés à retourner).

6. Tri automatique (trier les enregistrements de données par une propriété sélectionnée par l’utilisateur).

7. Page automatique (récupérer un sous-ensemble d’enregistrements de données sélectionnés par l’utilisateur).

Vous pouvez ajouter des conditions à la Where propriété pour filtrer les enregistrements de données retournés à partir d’une requête. Si la Where propriété n’est pas définie, le LinqDataSource contrôle récupère chaque enregistrement de l’objet de données.

Classement des données

Vous utilisez la OrderBy propriété pour spécifier les noms des propriétés des données retournées par tri.

Regroupement de données

Vous utilisez la GroupBy propriété pour spécifier les propriétés utilisées pour consolider les enregistrements de données qui ont les mêmes valeurs. Lorsque vous regroupez des données, vous pouvez inclure Key et It, qui sont créées dynamiquement, dans la Select propriété. La Key propriété fait référence aux valeurs de la propriété ou des propriétés utilisées pour regrouper les données. Par exemple, si vous regroupez par une propriété nommée Category, la Key propriété contiendra toutes les valeurs uniques dans la Category propriété. La It propriété fait référence à une collection d’enregistrements individuels dans un regroupement de données. Vous pouvez itérer sur la It propriété pour récupérer les enregistrements individuels qui ont été consolidés dans l’opération de regroupement. Par exemple, si vous regroupez par une propriété nommée Category, la It propriété contient tous les enregistrements individuels qui partagent une valeur commune dans la Category propriété.

Vous utilisez la OrderGroupsBy propriété pour spécifier les propriétés à utiliser pour trier les données groupées. Lorsque vous regroupez des données, la OrderBy propriété spécifie la façon dont les enregistrements individuels dans les données groupées sont triés.

Par défaut, le LinqDataSource contrôle récupère les valeurs de toutes les propriétés d’un objet de données. Vous utilisez la Select propriété pour spécifier les propriétés à retourner si vous souhaitez utiliser un sous-ensemble de propriétés disponibles. L’opération Select est appliquée après les opérations Where, Order By et Group By. Par conséquent, si vous créez un nom alias dans une clause Select, l’alias n’est pas disponible dans les autres clauses.

Modifications des données

Vous pouvez spécifier si les modifications de données sont activées à l’aide des propriétés et EnableInsertEnableUpdate des EnableDeletepropriétés. L’interface utilisateur permettant de modifier des données à partir d’un LinqDataSource contrôle est généralement fournie via un contrôle lié aux données, tel qu’un DetailsView contrôle. En plus de définir EnableDelete, EnableInsertou EnableUpdate à true, les conditions suivantes sont requises pour activer les modifications automatiques des données :

• La Select propriété ne peut pas être affectée à une valeur.

• La GroupBy propriété ne peut pas être affectée à une valeur.

• La classe affectée à la ContextTypeName propriété doit dériver de DataContext.

• La propriété affectée à la TableName propriété doit dériver de Table<TEntity>.

Vous pouvez restreindre les propriétés affichées dans un contrôle lié aux données de deux manières. Vous pouvez définir la Select propriété sur un sous-ensemble de propriétés ou définir les champs d’un contrôle lié aux données en ajoutant DataControlField des contrôles. Toutefois, si vous définissez la Select propriété, cela signifie que les opérations de mise à jour, d’insertion et de suppression automatiques ne peuvent pas être activées. Si vous souhaitez activer les modifications automatiques des données pendant que vous travaillez avec un sous-ensemble de propriétés disponibles, ne définissez pas la Select propriété. Au lieu de cela, récupérez toutes les propriétés de l’objet de données et gérez celles qui sont affichées à l’aide du contrôle lié aux données. Lorsque vous utilisez le DetailsView contrôle ou le GridView contrôle, vous devez également définir le ou AutoGenerateColumns les AutoGenerateRows propriétés sur false. Cela empêche le contrôle lié aux données d’inclure automatiquement des boutons pour la modification et la suppression des données. Toutes les valeurs qui ne sont pas affichées dans le contrôle lié aux données sont stockées dans l’état d’affichage. Ils sont passés inchangés à la source de données lorsque la mise à jour des données est effectuée.

Évaluation des valeurs au moment de l’exécution

Si vous devez évaluer des valeurs au moment de l’exécution pour l’ordre, le filtrage ou les valeurs de regroupement, vous pouvez ajouter des paramètres aux regroupements ou OrderByParameters aux WhereParametersGroupByParametersOrderGroupsByParameterscollections.

Si vous souhaitez spécifier des valeurs par défaut, vous pouvez ajouter des paramètres à la InsertParameters collection.

Si vous souhaitez examiner ou modifier des valeurs avant l’exécution de l’opération de données, vous pouvez gérer les événements, InsertingSelectingou Updating les Deletingévénements. Vous pouvez également gérer ces événements afin d’annuler l’opération de données ou d’examiner les erreurs de validation qui se sont produites lorsque vous définissez des propriétés dans la classe de données en fonction de l’entrée utilisateur.

Pour examiner les valeurs une fois l’opération de données terminée, gérez les événements, les événements ou Updated les Deleted. InsertedSelected

Utilisation des procédures stockées

Vous utilisez le LinqDataSource contrôle pour récupérer des données d’une procédure stockée en créant un gestionnaire d’événements pour l’événement Selecting . Dans le gestionnaire d’événements, vous appelez la méthode dans la classe de contexte de données qui représente la procédure stockée et définissez le résultat sur la Result propriété de l’objet LinqDataSourceSelectEventArgs . Si vous souhaitez activer les opérations de mise à jour, d’insertion et de suppression automatiques pour les données, le type retourné par la méthode doit correspondre au type spécifié dans la TableName propriété. Pour plus d’informations sur la création de méthodes de contexte de données, consultez Guide pratique pour créer des méthodes DataContext mappées aux procédures stockées et aux fonctions (Concepteur O/R).

Syntaxe déclarative

<asp:LinqDataSource
    AutoGenerateOrderByClause="True|False"
    AutoGenerateWhereClause="True|False"
    AutoPage="True|False"
    AutoSort="True|False"
    ContextTypeName="string"
    EnableDelete="True|False"
    EnableInsert="True|False"
    EnableTheming="True|False"
    EnableUpdate="True|False"
    EnableViewState="True|False"
    GroupBy="string"
    ID="string"
    OnContextCreated="ContextCreated event handler"
    OnContextCreating="ContextCreating event handler"
    OnContextDisposing="ContextDisposing event handler"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelected="Selected event handler"
    OnSelecting="Selecting event handler"
    OnUnload="Unload event handler"
    OnUpdated="Updated event handler"
    OnUpdating="Updating event handler"
    OrderBy="string"
    runat="server"
    Select="string"
    SkinID="string"
    StoreOriginalValuesInViewState="True|False"
    TableName="string"
    Visible="True|False"
    Where="string"
>
        <GroupByParameters />
        <InsertParameters />
        <OrderByParameters />
        <SelectParameters />
        <WhereParameters />
</asp:LinqDataSource>

Voir aussi

• LINQ to SQL