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 des données d’une classe d’entité nommée Products. La classe d’entité peut avoir été générée à l’aide de l’Designer O/R ou de l’utilitaire SqlMetal.exe. La Where propriété est définie pour renvoyer uniquement les enregistrements dont la valeur dans la Price propriété est supérieure à 50. 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, de supprimer et d’insérer des enregistrements dans la source de données. Un DetailsView contrôle est lié au LinqDataSource contrôle et permet aux utilisateurs de voir 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, ProductCategory et Color. 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 regroupées, et l’autre ListView contrôle affiche les noms individuels des produits qui appartiennent à ce groupe. La propriété du DataSource contrôle imbriqué lié aux données est définie sur Products, 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 de données

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

• Utilisation des procédures stockées

• Syntaxe déclarative

Introduction

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 dans n’importe quel . 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 TableName propriété sur la propriété ou le 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 propriété sur ContextTypeNamePerson et définissez la TableName propriété sur FavoriteCities.

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 l’utilitaire Concepteur Objet Relationnel ou SqlMetal.exe pour générer ces classes. Vous définissez ensuite la propriété sur ContextTypeName 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. Where (spécifiez les enregistrements de données à retourner).

2. Order By (tri).

3. Group By (agrégation des enregistrements de données qui partagent des valeurs).

4. Trier les groupes par (trier 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 selon une propriété que l’utilisateur a sélectionnée).

7. Page automatique (récupérer un sous-ensemble d’enregistrements de données qui ont été 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 à trier.

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 des propriétés créées dynamiquement, dans la Select propriété . La Key propriété fait référence aux valeurs de la ou des propriétés qui ont été 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 de 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 avec alias dans une clause Select, l’alias n’est pas disponible dans les autres clauses.

Modifications de données

Vous pouvez spécifier si les modifications de données sont activées à l’aide des EnableDeletepropriétés , EnableInsertet EnableUpdate . 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 sur true, les conditions suivantes sont requises pour activer les modifications automatiques des données :

• Une valeur ne peut pas être attribuée à la Select propriété.

• Une valeur ne peut pas être attribuée à la GroupBy propriété.

• 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 propriété sur Select 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 les propriétés ou AutoGenerateColumns sur falseAutoGenerateRows . Cela empêche le contrôle lié aux données d’inclure automatiquement des boutons permettant de modifier et de supprimer les 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 transmis sans modification à 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 le classement, le filtrage ou le WhereParametersregroupement des valeurs, vous pouvez ajouter des paramètres aux collections , GroupByParameters, OrderGroupsByParametersou OrderByParameters .

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 Deletingévénements , Inserting, Selectingou Updating . 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 Deletedévénements , Inserted, Selectedou Updated .

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 How to: Create DataContext methods map to stored procedures and functions (O/R Designer).

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>  

Constructeurs

Propriétés

Méthodes

Événements

Implémentations d’interfaces explicites

Méthodes d’extension

S’applique à

Voir aussi

• LINQ to SQL