Partager via


LinqDataSource Classe

Définition

Permet l’utilisation de LINQ (Language-Integrated Query) dans une page web ASP.NET dans du texte de balisage pour récupérer et modifier des données à partir d’un objet de données.

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
Héritage
Attributs
Implémente

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

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.

Notes

Lorsque vous utilisez le LinqDataSource contrôle avec SQL Server 2000 ou SQL Server Compact 3.5 et que la propriété a la AutoPagetruevaleur , vous devez fournir une valeur dans la OrderBy propriété. Par défaut, la AutoPage propriété est true. Si vous affectez une valeur à la Select propriété, vous devez également inclure toutes les colonnes d’identité dans la liste des propriétés retournées dans la requête.

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 :

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

LinqDataSource()

Initialise une nouvelle instance de la classe LinqDataSource.

Propriétés

Adapter

Obtient l'adaptateur spécifique au navigateur pour le contrôle.

(Hérité de Control)
AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle.

(Hérité de Control)
AutoGenerateOrderByClause

Obtient ou définit une valeur qui indique si le contrôle LinqDataSource crée dynamiquement une clause Order By en fonction des valeurs dans la collection OrderByParameters.

AutoGenerateWhereClause

Obtient ou définit une valeur qui indique si le contrôle LinqDataSource crée dynamiquement une clause Where basée sur les valeurs définies dans la collection WhereParameters.

AutoPage

Obtient ou définit une valeur qui indique si le contrôle LinqDataSource prend en charge la navigation dans les sections de données lors de l’exécution.

AutoSort

Récupère ou définit une valeur qui indique si le contrôle LinqDataSource prend en charge le tri des données lors de l’exécution.

BindingContainer

Obtient le contrôle qui contient la liaison de données de ce contrôle.

(Hérité de Control)
ChildControlsCreated

Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés.

(Hérité de Control)
ClientID

Obtient l'identificateur de contrôle serveur généré par ASP.NET.

(Hérité de DataSourceControl)
ClientIDMode

Cette propriété n'est pas utilisée pour les contrôles de source de données.

(Hérité de DataSourceControl)
ClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID.

(Hérité de Control)
Context

Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours.

(Hérité de Control)
ContextTypeName

Obtient ou définit le nom du type qui contient la propriété dont la valeur correspond aux données que vous souhaitez récupérer.

Controls

Obtient un objet ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur.

(Hérité de DataSourceControl)
DataItemContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer.

(Hérité de Control)
DataKeysContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl.

(Hérité de Control)
DeleteParameters

Cette propriété n'est pas utilisée par la classe LinqDataSource.

DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.

(Hérité de Control)
EnableDelete

Obtient ou définit une valeur qui indique si les enregistrements de données peuvent être supprimés via le contrôle LinqDataSource.

EnableInsert

Obtient ou définit une valeur qui indique si les enregistrements de données peuvent être insérés via le contrôle LinqDataSource.

EnableObjectTracking

Obtient ou définit la valeur qui indique si les modifications apportées à l'objet de contexte de données font l'objet d'un suivi.

EnableTheming

Obtient une valeur indiquant si cet objet prend en charge des thèmes.

(Hérité de DataSourceControl)
EnableUpdate

Obtient ou définit une valeur qui indique si les enregistrements de données peuvent être mis à jour via le contrôle LinqDataSource.

EnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.

(Hérité de Control)
EntitySetName

Obtient ou définit le nom de la propriété ou du champ de l'objet source de données qui représente une collection de données.

(Hérité de ContextDataSource)
EntityTypeName

Obtient ou définit le nom du type créé pour les opérations d'insertion, de suppression et de mise à jour.

(Hérité de ContextDataSource)
Events

Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule.

(Hérité de Control)
GroupBy

Obtient ou définit une valeur qui spécifie les propriétés utilisées pour regrouper les données récupérées.

GroupByParameters

Obtient la collection de paramètres utilisés pour créer la clause Group By.

HasChildViewState

Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés.

(Hérité de Control)
ID

Obtient ou définit l'ID programmatique assigné au contrôle serveur.

(Hérité de Control)
IdSeparator

Obtient le caractère utilisé pour séparer des identificateurs de contrôle.

(Hérité de Control)
InsertParameters

Obtient la collection de paramètres utilisés lors d'une opération d'insertion.

IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle.

(Hérité de Control)
IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage.

(Hérité de Control)
IsViewStateEnabled

Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle.

(Hérité de Control)
LoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index.

(Hérité de Control)
NamingContainer

Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur.

(Hérité de Control)
OrderBy

Obtient ou définit une valeur qui spécifie les champs utilisés pour classer les données récupérées.

OrderByParameters

Obtient la collection de paramètres utilisés pour créer la clause Order By.

OrderGroupsBy

Obtient ou définit les champs utilisés pour trier des données groupées.

OrderGroupsByParameters

Obtient la collection de paramètres utilisés pour créer la clause Order Groups By.

Page

Obtient une référence à l'instance de Page qui contient le contrôle serveur.

(Hérité de Control)
Parent

Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page.

(Hérité de Control)
RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.

(Hérité de Control)
Select

Obtient ou définit les propriétés et les valeurs calculées incluses dans les données récupérées.

SelectParameters

Obtient la collection de paramètres utilisés lors d'une opération de récupération de données.

Site

Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception.

(Hérité de Control)
SkinID

Obtient l'apparence à appliquer au contrôle DataSourceControl.

(Hérité de DataSourceControl)
StoreOriginalValuesInViewState

Obtient ou définit une valeur qui indique si les données de la source de données doivent être stockées dans l'état d'affichage pour s'assurer que les données n'ont pas été modifiées par un autre processus avant leur mise à jour ou leur suppression.

TableName

Obtient ou définit le nom de la propriété ou du champ de la classe de contexte de données qui représente une collection de données.

TemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.

(Hérité de Control)
TemplateSourceDirectory

Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours.

(Hérité de Control)
UniqueID

Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur.

(Hérité de Control)
UpdateParameters

Cette collection n'est pas utilisée par la classe LinqDataSource.

ValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses.

(Hérité de Control)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l'objet StateBag respecte la casse.

(Hérité de Control)
ViewStateMode

Obtient ou définit le mode d'état d'affichage de ce contrôle.

(Hérité de Control)
Visible

Obtient ou définit une valeur indiquant l'affichage visuel ou non du contrôle.

(Hérité de DataSourceControl)
Where

Obtient ou définit une valeur qui spécifie les conditions qui doivent être remplies pour qu'un enregistrement soit inclus dans les données récupérées.

WhereParameters

Obtient la collection de paramètres utilisée pour créer la clause Where.

Méthodes

AddedControl(Control, Int32)

Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control.

(Hérité de Control)
AddParsedSubObject(Object)

Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur.

(Hérité de Control)
ApplyStyleSheetSkin(Page)

Applique les propriétés de style qui sont définies dans la feuille de style de la page au contrôle.

(Hérité de DataSourceControl)
BeginRenderTracing(TextWriter, Object)

Commence le traçage au moment du design des données de rendu.

(Hérité de Control)
BuildProfileTree(String, Boolean)

Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page.

(Hérité de Control)
ClearCachedClientID()

Affecte à la valeur ClientID mise en cache la valeur null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildState()

Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildViewState()

Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearEffectiveClientIDMode()

Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants.

(Hérité de Control)
CreateChildControls()

Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu.

(Hérité de Control)
CreateControlCollection()

Crée une collection pour stocker des contrôles enfants.

(Hérité de DataSourceControl)
CreateQueryableView()

Retourne un affichage pouvant être interrogé.

CreateView()

Crée une nouvelle instance de la classe LinqDataSourceView associée à ce contrôle.

DataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.

(Hérité de Control)
DataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding.

(Hérité de Control)
DataBindChildren()

Lie une source de données aux contrôles enfants du contrôle serveur.

(Hérité de Control)
Delete(IDictionary, IDictionary)

Exécute une opération de suppression.

Dispose()

Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire.

(Hérité de Control)
EndRenderTracing(TextWriter, Object)

Met fin au traçage au moment du design des données de rendu.

(Hérité de Control)
EnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée.

(Hérité de Control)
EnsureID()

Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné.

(Hérité de Control)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
FindControl(String)

Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.

(Hérité de DataSourceControl)
FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

(Hérité de Control)
Focus()

Définit le focus d'entrée sur le contrôle.

(Hérité de DataSourceControl)
GetDesignModeState()

Obtient les données au moment du design pour un contrôle.

(Hérité de Control)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetRouteUrl(Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié.

(Hérité de Control)
GetView(String)

Retourne la vue de source de données associée à l’objet LinqDataSource.

GetView(String)

Obtient la vue de source de données associée à l'objet QueryableDataSource.

(Hérité de QueryableDataSource)
GetViewNames()

Retourne une collection des noms qui représente la liste d’objets de vue associée au contrôle LinqDataSource.

GetViewNames()

Obtient une collection de noms qui représentent les affichages associés au contrôle QueryableDataSource.

(Hérité de QueryableDataSource)
HasControls()

Détermine si le contrôle serveur contient des contrôles enfants.

(Hérité de DataSourceControl)
HasEvents()

Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants.

(Hérité de Control)
Insert(IDictionary)

Exécute une opération d'insertion.

IsLiteralContent()

Détermine si le contrôle serveur ne détient qu'un contenu littéral.

(Hérité de Control)
LoadControlState(Object)

Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState().

(Hérité de Control)
LoadViewState(Object)

Charge l'état des valeurs du contrôle LinqDataSource qui doivent être persistantes.

LoadViewState(Object)

Charge l'état des valeurs du contrôle QueryableDataSource qui doivent être persistantes.

(Hérité de QueryableDataSource)
MapPathSecure(String)

Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond.

(Hérité de Control)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnBubbleEvent(Object, EventArgs)

Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page.

(Hérité de Control)
OnDataBinding(EventArgs)

Déclenche l’événement DataBinding.

(Hérité de Control)
OnInit(EventArgs)

Initialise l'objet LinqDataSource.

OnLoad(EventArgs)

Déclenche l’événement Load.

(Hérité de Control)
OnPreRender(EventArgs)

Déclenche l’événement PreRender.

(Hérité de Control)
OnUnload(EventArgs)

Déclenche l’événement Unload.

OpenFile(String)

Obtient un Stream utilisé pour lire un fichier.

(Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)

Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.

(Hérité de Control)
RaiseDataSourceChangedEvent(EventArgs)

Déclenche l’événement DataSourceChanged.

(Hérité de DataSourceControl)
RaiseViewChanged()

Appelle la méthode OnDataSourceViewChanged(EventArgs) de la classe DataSourceView.

(Hérité de QueryableDataSource)
RemovedControl(Control)

Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control.

(Hérité de Control)
Render(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter, qui écrit le contenu à rendre sur le client.

(Hérité de Control)
RenderChildren(HtmlTextWriter)

Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client.

(Hérité de Control)
RenderControl(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé.

(Hérité de DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.

(Hérité de Control)
ResolveAdapter()

Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié.

(Hérité de Control)
ResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.

(Hérité de Control)
ResolveUrl(String)

Convertit une URL en une URL que le client soit en mesure d'utiliser.

(Hérité de Control)
SaveControlState()

Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur.

(Hérité de Control)
SaveViewState()

Enregistre l'état d'affichage actuel du contrôle LinqDataSource.

SaveViewState()

Enregistre l'état d'affichage actuel du contrôle QueryableDataSource.

(Hérité de QueryableDataSource)
SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.

(Hérité de Control)
SetRenderMethodDelegate(RenderMethod)

Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent.

(Hérité de Control)
SetTraceData(Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
SetTraceData(Object, Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TrackViewState()

Suit les modifications d'état d'affichage apportées au contrôle LinqDataSource afin que les modifications puissent être stockées dans l'objet StateBag du contrôle.

TrackViewState()

Suit les modifications d'état d'affichage apportées au contrôle QueryableDataSource afin que les modifications puissent être stockées dans l'objet StateBag du contrôle.

(Hérité de QueryableDataSource)
Update(IDictionary, IDictionary, IDictionary)

Exécute une opération de mise à jour.

UpdateParameterVales()

Met à jour les valeurs de paramètres qui ont changé depuis la demande précédente.

(Hérité de QueryableDataSource)

Événements

ContextCreated

Se produit après la création d'une instance du type d'objet de contexte.

ContextCreating

Se produit avant la création d'une instance du type d'objet de contexte.

ContextDisposing

Se produit avant la suppression du type d'objet de contexte.

DataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.

(Hérité de Control)
Deleted

Se produit une fois l'opération de suppression terminée.

Deleting

Se produit avant une opération de suppression.

Disposed

Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET.

(Hérité de Control)
Init

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie.

(Hérité de Control)
Inserted

Se produit une fois l'opération d'insertion terminée.

Inserting

Se produit avant une opération d'insertion.

Load

Se produit lorsque le contrôle serveur est chargé dans l'objet Page.

(Hérité de Control)
PreRender

Se produit après le chargement de l'objet Control mais avant le rendu.

(Hérité de Control)
QueryCreated

Se produit lorsqu'une requête est ajoutée à un contrôle de source de données ou en est supprimée.

(Hérité de QueryableDataSource)
Selected

Se produit une fois l'opération de récupération de données terminée.

Selecting

Se produit avant une opération de récupération de données.

Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.

(Hérité de Control)
Updated

Se produit une fois l'opération de mise à jour terminée.

Updating

Se produit avant une opération de mise à jour.

Implémentations d’interfaces explicites

IControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez ControlBuilder.

(Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez GetDesignModeState().

(Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).

(Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).

(Hérité de Control)
IControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez UserData.

(Hérité de Control)
IDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez DataBindings.

(Hérité de Control)
IDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez HasDataBindings.

(Hérité de Control)
IDataSource.DataSourceChanged

Se produit lorsqu'un contrôle de code source de données a changé d'une manière qui affecte des contrôles liés aux données.

(Hérité de DataSourceControl)
IDataSource.GetView(String)

Obtient l'objet nommé DataSourceView associé au contrôle DataSourceControl. Certains contrôles de code source de données ne prennent en charge qu'un affichage, contrairement à d'autres qui en gèrent plusieurs.

(Hérité de DataSourceControl)
IDataSource.GetViewNames()

Obtient une collection de noms, représentant la liste des objets DataSourceView associés au contrôle DataSourceControl.

(Hérité de DataSourceControl)
IDynamicDataSource.ContextType

Pour obtenir une description de ce membre, consultez IDynamicDataSource.

IDynamicDataSource.EntitySetName

Pour obtenir une description de ce membre, consultez IDynamicDataSource.

IDynamicDataSource.Exception

Pour obtenir une description de ce membre, consultez IDynamicDataSource.

IExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez Expressions.

(Hérité de Control)
IExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez HasExpressions.

(Hérité de Control)
IListSource.ContainsListCollection

Indique si le contrôle de code source de données est associé à une ou à plusieurs listes de données.

(Hérité de DataSourceControl)
IListSource.GetList()

Obtient une liste des contrôles de code source de données qui peuvent être utilisés comme sources des listes de données.

(Hérité de DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).

(Hérité de Control)

Méthodes d’extension

ExpandDynamicWhereParameters(IDynamicDataSource)

Développe des filtres dynamiques dans les paramètres Where qui sont utilisables par la source de données.

FindDataSourceControl(Control)

Retourne la source de données associée au contrôle de données pour le contrôle spécifié.

FindFieldTemplate(Control, String)

Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié.

FindMetaTable(Control)

Retourne l'objet Metatable pour le contrôle de données conteneur.

GetDefaultValues(IDataSource)

Obtient la collection des valeurs par défaut pour la source de données spécifiée.

GetMetaTable(IDataSource)

Obtient les métadonnées pour une table dans l'objet source de données spécifié.

GetTable(IDynamicDataSource)

Retourne l'objet MetaTable associé au contrôle de source de données spécifié.

LoadWith<TEntity>(LinqDataSource)

Définit la valeur DataLoadOptions d'une source de données LINQ-to-SQL pour forcer le chargement de toutes les entités de clé étrangère.

LoadWithForeignKeys(LinqDataSource, Type)

Définit la valeur DataLoadOptions d'une source de données LINQ-to-SQL pour forcer le chargement de toutes les entités de clé étrangère.

TryGetMetaTable(IDataSource, MetaTable)

Détermine si des métadonnées de table sont disponibles.

S’applique à

Voir aussi