ObjectDataSource Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente un objet métier qui fournit des données aux contrôles liés aux données dans des architectures multicouches d'application Web.

public ref class ObjectDataSource : System::Web::UI::DataSourceControl

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))>]
type ObjectDataSource = class
    inherit DataSourceControl

Public Class ObjectDataSource
Inherits DataSourceControl

Héritage: Object

Control

DataSourceControl
ObjectDataSource

Attributs: ToolboxBitmapAttribute

Exemples

Cette section montre un ObjectDataSource dans le balisage dans une page de .aspx et les objets métier avec ant. L’exemple est la page .aspx. Il contient un GridView contrôle lié à un ObjectDataSource contrôle. Le ObjectDataSource balisage de contrôle spécifie le nom de l’objet métier et le nom de la méthode d’objet métier à appeler afin de récupérer des données.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ 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>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.CS.EmployeeLogic" />

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ 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>
    <title>ObjectDataSource - Visual Basic Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.VB.EmployeeLogic" />

    </form>
  </body>
</html>

L’exemple suivant montre l’objet métier utilisé par le ObjectDataSource contrôle dans la page .aspx. (De nombreux autres ObjectDataSource exemples de code utilisent également cet objet métier.) L’exemple se compose des deux classes de base suivantes :

La EmployeeLogic classe est la classe logique métier que le ObjectDataSource utilise.
La NorthwindEmployee classe définit l’objet de données retourné par la GetAllEmployees méthode de la EmployeeLogic classe .

Une classe supplémentaire NorthwindDataException est fournie à titre pratique.

Cet ensemble d’exemples de classes fonctionne avec la base de données Northwind Traders, disponible avec Microsoft SQL Server et Microsoft Access. Pour obtenir un exemple de travail complet, vous devez compiler et utiliser ces classes avec l’exemple de page .aspx fourni.

namespace Samples.AspNet.CS {

using System;
using System.Collections;
using System.Collections.Specialized;
using System.Configuration;
using System.Data;
using System.Data.SqlClient;
using System.Web.UI;
using System.Web.UI.WebControls;
  //
  // EmployeeLogic is a stateless business object that encapsulates
  // the operations one can perform on a NorthwindEmployee object.
  //
  public class EmployeeLogic {

    // Returns a collection of NorthwindEmployee objects.
    public static ICollection GetAllEmployees () {
      ArrayList al = new ArrayList();

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

      SqlDataSource sds
        = new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");

      try {

        IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);

        // Iterate through the Enumeration and create a
        // NorthwindEmployee object for each ID.
        foreach (DataRowView row in IDs) {
          string id = row["EmployeeID"].ToString();
          NorthwindEmployee nwe = new NorthwindEmployee(id);
          // Add the NorthwindEmployee object to the collection.
          al.Add(nwe);
        }
      }
      finally {
        // If anything strange happens, clean up.
        sds.Dispose();
      }

      return al;
    }
    public static NorthwindEmployee GetEmployee(object anID) {
      return new NorthwindEmployee(anID);
    }

    public static void UpdateEmployeeInfo(NorthwindEmployee ne) {
      bool retval = ne.Save();
      if (! retval) { throw new NorthwindDataException("UpdateEmployee failed."); }
    }

    public static void DeleteEmployee(NorthwindEmployee ne) { }
  }

  public class NorthwindEmployee {

    public NorthwindEmployee () {
      ID = DBNull.Value;
      lastName = "";
      firstName = "";
      title="";
      titleOfCourtesy = "";
      reportsTo = -1;
    }

    public NorthwindEmployee (object anID) {
      this.ID = anID;

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

        SqlConnection conn = new SqlConnection (cts.ConnectionString);
      SqlCommand sc =
        new SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " +
                       " FROM Employees " +
                       " WHERE EmployeeID = @empId",
                       conn);
      // Add the employee ID parameter and set its value.
      sc.Parameters.Add(new SqlParameter("@empId",SqlDbType.Int)).Value = Int32.Parse(anID.ToString());
      SqlDataReader sdr = null;

      try {
        conn.Open();
        sdr = sc.ExecuteReader();

        // This is not a while loop. It only loops once.
        if (sdr != null && sdr.Read()) {
          // The IEnumerable contains DataRowView objects.
          this.firstName        = sdr["FirstName"].ToString();
          this.lastName         = sdr["LastName"].ToString();
          this.title            = sdr["Title"].ToString();
          this.titleOfCourtesy  = sdr["TitleOfCourtesy"].ToString();
          if (! sdr.IsDBNull(4)) {
            this.reportsTo        = sdr.GetInt32(4);
          }
        }
        else {
          throw new NorthwindDataException("Data not loaded for employee id.");
        }
      }
      finally {
        try {
          if (sdr != null) sdr.Close();
          conn.Close();
        }
        catch (SqlException) {
          // Log an event in the Application Event Log.
          throw;
        }
      }
    }

    private object ID;

    private string lastName;
    public string LastName {
      get { return lastName; }
      set { lastName = value; }
    }

    private string firstName;
    public string FirstName {
      get { return firstName; }
      set { firstName = value;  }
    }

    private string title;
    public String Title {
      get { return title; }
      set { title = value; }
    }

    private string titleOfCourtesy;
    public string Courtesy {
      get { return titleOfCourtesy; }
      set { titleOfCourtesy = value; }
    }

    private int    reportsTo;
    public int Supervisor {
      get { return reportsTo; }
      set { reportsTo = value; }
    }

    public bool Save () {
      return true;
    }
  }

  internal class NorthwindDataException: Exception {
    public NorthwindDataException(string msg) : base (msg) { }
  }
}

Imports System.Collections
Imports System.Configuration
Imports System.Data
Imports System.Data.SqlClient
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB
'
' EmployeeLogic is a stateless business object that encapsulates
' the operations you can perform on a NorthwindEmployee object.
' When the class is written in Visual Basic, you cannot use the Shared
' part.
Public Class EmployeeLogic
   ' Returns a collection of NorthwindEmployee objects.
   Public Shared Function GetAllEmployees() As ICollection
      Dim al As New ArrayList()

      Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
      Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
      Try
         Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)

         ' Iterate through the Enumeration and create a
         ' NorthwindEmployee object for each ID.
         For Each row As DataRowView In IDs
            Dim id As String = row("EmployeeID").ToString()
            Dim nwe As New NorthwindEmployee(id)
            ' Add the NorthwindEmployee object to the collection.
            al.Add(nwe)
         Next
      Finally
         ' If anything strange happens, clean up.
         sds.Dispose()
      End Try

      Return al
   End Function 'GetAllEmployees

   Public Shared Function GetEmployee(anID As Object) As NorthwindEmployee
      Return New NorthwindEmployee(anID)
   End Function 'GetEmployee


   Public Shared Sub UpdateEmployeeInfo(ne As NorthwindEmployee)
      Dim retval As Boolean = ne.Save()
      If Not retval Then
         Throw New NorthwindDataException("UpdateEmployee failed.")
      End If
   End Sub

   Public Shared Sub DeleteEmployee(ne As NorthwindEmployee)
   End Sub

End Class


Public Class NorthwindEmployee


   Public Sub New()
      ID = DBNull.Value
      aLastName = ""
      aFirstName = ""
      aTitle = ""
      titleOfCourtesy = ""
      reportsTo = - 1
   End Sub


   Public Sub New(anID As Object)
      Me.ID = anID
      Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
      Dim conn As New SqlConnection(cts.ConnectionString)
      Dim sc As New SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " & _
                               " FROM Employees " & _
                               " WHERE EmployeeID = @empId", conn)
      ' Add the employee ID parameter and set its value.
      sc.Parameters.Add(New SqlParameter("@empId", SqlDbType.Int)).Value = Int32.Parse(anID.ToString())
      Dim sdr As SqlDataReader = Nothing

      Try
         conn.Open()
         sdr = sc.ExecuteReader()

         ' This is not a while loop. It only loops once.
         If Not (sdr Is Nothing) AndAlso sdr.Read() Then
            ' The IEnumerable contains DataRowView objects.
            Me.aFirstName = sdr("FirstName").ToString()
            Me.aLastName = sdr("LastName").ToString()
            Me.aTitle = sdr("Title").ToString()
            Me.titleOfCourtesy = sdr("TitleOfCourtesy").ToString()
            If Not sdr.IsDBNull(4) Then
               Me.reportsTo = sdr.GetInt32(4)
            End If
         Else
            Throw New NorthwindDataException("Data not loaded for employee id.")
         End If
      Finally
         Try
            If Not (sdr Is Nothing) Then
               sdr.Close()
            End If
            conn.Close()
         Catch se As SqlException
            ' Log an event in the Application Event Log.
            Throw
         End Try
      End Try
   End Sub

   Private ID As Object

   Private aLastName As String
   Public Property LastName() As String
      Get
         Return aLastName
      End Get
      Set
         aLastName = value
      End Set
   End Property

   Private aFirstName As String
   Public Property FirstName() As String
      Get
         Return aFirstName
      End Get
      Set
         aFirstName = value
      End Set
   End Property

   Private aTitle As String
   Public Property Title() As String
      Get
         Return aTitle
      End Get
      Set
         aTitle = value
      End Set
   End Property

   Private titleOfCourtesy As String
   Public Property Courtesy() As String
      Get
         Return titleOfCourtesy
      End Get
      Set
         titleOfCourtesy = value
      End Set
   End Property
   Private reportsTo As Integer

   Public Property Supervisor() As Integer
      Get
         Return reportsTo
      End Get
      Set
         reportsTo = value
      End Set
   End Property

   Public Function Save() As Boolean
      Return True
   End Function 'Save
End Class


Friend Class NorthwindDataException
   Inherits Exception

   Public Sub New(msg As String)
      MyBase.New(msg)
   End Sub
End Class
End Namespace

Remarques

Dans cette rubrique :

Introduction
Objectif
Récupération de données
Exécution d’opérations de données
Filtrage des données
Mise en cache
Caractéristiques
Vue de données
Utilisation de LINQ to SQL
Syntaxe déclarative

Introduction

Un ObjectDataSource contrôle fonctionne avec une classe que vous créez. Vous créez des méthodes qui récupèrent et mettent à jour des données, et vous fournissez les noms de ces méthodes au contrôle dans le ObjectDataSource balisage. Pendant le traitement du rendu ou de la publication, le ObjectDataSource appelle les méthodes que vous avez spécifiées.

Il n’existe aucun rendu visuel du ObjectDataSource contrôle. Par conséquent, le ne prend pas en charge les ObjectDataSource fonctionnalités visuelles telles que la EnableTheming propriété ou SkinID .

Objectif

Une pratique de conception d’application très courante consiste à séparer la couche de présentation de la logique métier et à encapsuler la logique métier dans les objets métier. Ces objets métier forment une couche distincte entre la couche de présentation et la couche Données, ce qui aboutit à une architecture d’application à trois niveaux. Le ObjectDataSource contrôle permet aux développeurs d’utiliser un contrôle de source de données ASP.NET tout en conservant leur architecture d’application à trois niveaux.

Le ObjectDataSource contrôle utilise la réflexion pour créer des instances d’objets métier et pour appeler des méthodes sur ceux-ci pour récupérer, mettre à jour, insérer et supprimer des données. La TypeName propriété identifie le nom de la classe avec laquelle fonctionne.ObjectDataSource Le ObjectDataSource contrôle crée et détruit une instance de la classe pour chaque appel de méthode ; il ne conserve pas l’objet en mémoire pendant toute la durée de vie de la requête Web. Il s’agit d’une considération sérieuse si l’objet métier que vous utilisez nécessite de nombreuses ressources ou s’il est autrement coûteux à créer et à détruire. L’utilisation d’un objet coûteux peut ne pas être un choix de conception optimal, mais vous pouvez contrôler le cycle de vie de l’objet à l’aide des ObjectCreatingévénements , ObjectCreatedet ObjectDisposing .

Notes

Les méthodes identifiées par les SelectMethodpropriétés , UpdateMethod, InsertMethodet DeleteMethod peuvent être des méthodes d’instance ou static (Shared en Visual Basic). Si les méthodes sont static (Shared en Visual Basic), aucune instance de l’objet métier n’est créée, et les ObjectCreatingévénements , ObjectCreatedet ObjectDisposing ne sont pas déclenchés.

Récupération de données

Pour récupérer des données à partir d’un objet métier, définissez la SelectMethod propriété sur le nom de la méthode qui récupère les données. Si la méthode ne retourne pas d’objet IEnumerable ou DataSet , l’objet est encapsulé par le runtime dans une IEnumerable collection. Si la signature de méthode a des paramètres, vous pouvez ajouter Parameter des objets à la SelectParameters collection, puis les lier aux valeurs que vous souhaitez passer à la méthode spécifiée par la SelectMethod propriété . Pour que le ObjectDataSource contrôle utilise les paramètres, ceux-ci doivent correspondre aux noms et aux types des paramètres dans la signature de méthode. Pour plus d’informations, consultez Utilisation de paramètres avec le contrôle ObjectDataSource.

Le ObjectDataSource contrôle récupère des données chaque fois que la Select méthode est appelée. Cette méthode fournit un accès programmatique à la méthode spécifiée par SelectMethod la propriété . La méthode spécifiée par la SelectMethod propriété est appelée automatiquement par les contrôles qui sont liés au ObjectDataSource lorsque leur DataBind méthode est appelée. Si vous définissez la DataSourceID propriété d’un contrôle lié aux données, le contrôle se lie automatiquement aux données de la source de données, selon les besoins. La définition de la DataSourceID propriété est la méthode recommandée pour lier un ObjectDataSource contrôle à un contrôle lié aux données. Vous pouvez également définir la DataSource propriété, mais vous devez appeler explicitement la DataBind méthode du contrôle lié aux données. Vous pouvez appeler la Select méthode par programmation à tout moment pour récupérer des données.

Pour plus d’informations sur la liaison de contrôles liés aux données aux contrôles de source de données, consultez Liaison à des données à l’aide d’un contrôle de source de données.

Exécution d’opérations de données

En fonction des fonctionnalités de l’objet métier avec lequel le ObjectDataSource contrôle fonctionne, vous pouvez effectuer des opérations de données, telles que des mises à jour, des insertions et des suppressions. Pour effectuer ces opérations de données, définissez le nom de la méthode appropriée et tous les paramètres associés pour l’opération que vous souhaitez effectuer. Par exemple, pour une opération de mise à jour, définissez la UpdateMethod propriété sur le nom de la méthode d’objet métier qui effectue les mises à jour et ajoutez tous les paramètres requis à la UpdateParameters collection. Si le ObjectDataSource contrôle est associé à un contrôle lié aux données, les paramètres sont ajoutés par le contrôle lié aux données. Dans ce cas, vous devez vous assurer que les noms de paramètres de la méthode correspondent aux noms de champs dans le contrôle lié aux données. La mise à jour est effectuée lorsque la Update méthode est appelée, soit explicitement par votre code, soit automatiquement par un contrôle lié aux données. Le même modèle général est suivi pour Delete les opérations et Insert . Les objets métier sont supposés effectuer ces types d’opérations de données un enregistrement à la fois, plutôt que par lot.

Filtrage des données

Le ObjectDataSource contrôle peut filtrer les données récupérées par la SelectMethod propriété si les données sont retournées en tant qu’objet DataSet ou DataTable . Vous pouvez définir la FilterExpression propriété sur une expression de filtrage à l’aide d’une syntaxe de chaîne de format et lier les valeurs de l’expression aux paramètres spécifiés dans la FilterParameters collection.

Mise en cache

Bien que le ObjectDataSource ne conserve pas l’instance de l’objet métier sur plusieurs requêtes, il peut mettre en cache le résultat de l’appel de la méthode identifiée par la SelectMethod propriété . Pendant que les données sont mises en cache, les appels suivants à la Select méthode retournent les données mises en cache au lieu de créer l’objet métier et d’appeler son SelectMethod à l’aide de la réflexion. La mise en cache vous permet d’éviter de créer l’objet et d’appeler sa méthode de données au détriment de la mémoire sur le serveur Web. le ObjectDataSource met automatiquement en cache les données lorsque la EnableCaching propriété a la truevaleur , et la CacheDuration propriété est définie sur le nombre de secondes pendant lesquelles le cache stocke les données avant que le cache ne soit ignoré. Vous pouvez également spécifier une CacheExpirationPolicy propriété et une propriété facultative SqlCacheDependency . Le ObjectDataSource contrôle vous permet de mettre en cache tous les types de données, mais vous ne devez pas mettre en cache des objets qui conservent des ressources ou un état qui ne peuvent pas être partagés pour traiter plusieurs demandes (par exemple, un objet ouvert SqlDataReader ), car la même instance de l’objet sera utilisée pour traiter plusieurs demandes.

Fonctionnalités

Le tableau suivant décrit les fonctionnalités du ObjectDataSource contrôle.

Fonctionnalité	Spécifications
Sélectionnez	Définissez la SelectMethod propriété sur le nom de la méthode d’objet métier qui sélectionne les données et incluez tous les paramètres nécessaires dans la SelectParameters collection par programmation ou à l’aide d’un contrôle lié aux données.
Tri	Définissez la SortParameterName propriété sur le nom du paramètre dans la SelectMethod méthode qui contient les critères de tri.
Filtrage	Définissez la FilterExpression propriété sur une expression de filtrage et ajoutez éventuellement des paramètres à la FilterParameters collection pour filtrer les données lorsque la Select méthode est appelée. La méthode spécifiée par la SelectMethod propriété doit retourner un DataSet ou DataTable.
Pagination	La pagination de source de données est prise en charge si la SelectMethod méthode contient des paramètres pour le nombre maximal d’enregistrements à récupérer et l’index du premier enregistrement à récupérer. Les noms de ces paramètres doivent être définis dans les MaximumRowsParameterName propriétés et StartRowIndexParameterName , respectivement. Un contrôle lié aux données peut être en mesure d’effectuer lui-même la pagination, même si le contrôle ne prend pas en charge la ObjectDataSource pagination directement dans la méthode spécifiée par la SelectMethod propriété . La condition requise pour que le contrôle lié aux données puisse effectuer cette opération est que la méthode spécifiée par la SelectMethod propriété retourne un objet qui implémente l’interface ICollection .
Mise à jour	Définissez la UpdateMethod propriété sur le nom de la méthode d’objet métier qui met à jour les données et incluez tous les paramètres nécessaires dans la UpdateParameters collection.
Suppression	Définissez la DeleteMethod propriété sur le nom de la méthode ou de la fonction d’objet métier qui supprime les données, et incluez tous les paramètres nécessaires dans la DeleteParameters collection.
Insertion	Définissez la InsertMethod propriété sur le nom de la méthode ou de la fonction d’objet métier qui insère des données et incluez tous les paramètres nécessaires dans la InsertParameters collection.
Mise en cache	Définissez la propriété sur EnableCaching`true`, et les CacheDuration propriétés et CacheExpirationPolicy en fonction du comportement de mise en cache que vous souhaitez pour vos données mises en cache.

Notes

Lorsque vous utilisez la ObjectDataSource classe pour mettre à jour ou insérer des données, les chaînes entrées au niveau du client ne sont pas automatiquement converties du format de culture client au format de culture serveur. Par exemple, la culture du client peut spécifier JJ/MM/AAAA comme format de date, et le format de date sur le serveur peut être MM/JJ/AAAA. Dans ce cas, le 5 octobre 2009 serait inscrit dans un TextBox contrôle au 10/05/2009, mais serait interprété comme étant le 10 mai 2009. Le 15 octobre 2009 serait entré sous la forme 15/10/2009 et serait rejeté comme une date non valide.

Vue de données

Comme pour tous les contrôles de source de données, le ObjectDataSource contrôle est associé à une classe de vue de source de données. Bien que le ObjectDataSource contrôle soit l’interface que le développeur de pages utilise pour utiliser des données, la ObjectDataSourceView classe est l’interface avec laquelle les contrôles liés aux données fonctionnent. En outre, la ObjectDataSourceView classe décrit les fonctionnalités du contrôle de source de données et effectue le travail réel. Le ObjectDataSource contrôle n’a qu’un seul associé ObjectDataSourceView, et il est toujours nommé DefaultView. Bien que l’objet ObjectDataSourceView soit exposé par la GetView méthode, la plupart de ses propriétés et méthodes sont encapsulées et exposées directement par le ObjectDataSource contrôle. En arrière-plan, l’objet effectue toutes les opérations de données, notamment la récupération, l’insertion, la mise à jour, la suppression, le ObjectDataSourceView filtrage et le tri des données. Pour plus d'informations, consultez ObjectDataSourceView.

Utilisation de LINQ to SQL

Vous pouvez utiliser le ObjectDataSource contrôle avec une classe LINQ to SQL. Pour ce faire, vous définissez la TypeName propriété sur le nom de la classe de contexte de données. Vous définissez également les SelectMethodméthodes , UpdateMethod, InsertMethodet DeleteMethod sur les méthodes de la classe de contexte de données qui effectuent les opérations correspondantes. Vous devez créer un gestionnaire d’événements pour l’événement ObjectDisposing afin d’annuler la suppression de la classe de contexte de données. Cette étape est nécessaire, car LINQ to SQL prend en charge l’exécution différée, tandis que le ObjectDataSource contrôle tente de supprimer le contexte de données après l’opération Select. Pour plus d’informations sur la création de classes LINQ to SQL, consultez Guide pratique pour créer des classes LINQ to SQL dans un projet web. Pour obtenir un exemple d’annulation de la suppression d’une classe de contexte de données, consultez l’événement ObjectDisposing .

Utilisation d’Entity Framework

Vous pouvez également utiliser le ObjectDataSource contrôle avec Entity Framework. Pour plus d’informations, consultez Utilisation d’Entity Framework et du contrôle ObjectDataSource.

Syntaxe déclarative

<asp:ObjectDataSource
    CacheDuration="string|Infinite"
    CacheExpirationPolicy="Absolute|Sliding"
    CacheKeyDependency="string"
    ConflictDetection="OverwriteChanges|CompareAllValues"
    ConvertNullToDBNull="True|False"
    DataObjectTypeName="string"
    DeleteMethod="string"
    EnableCaching="True|False"
    EnablePaging="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FilterExpression="string"
    ID="string"
    InsertMethod="string"
    MaximumRowsParameterName="string"
    OldValuesParameterFormatString="string"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnFiltering="Filtering event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnObjectCreated="ObjectCreated event handler"
    OnObjectCreating="ObjectCreating event handler"
    OnObjectDisposing="ObjectDisposing 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"
    runat="server"
    SelectCountMethod="string"
    SelectMethod="string"
    SkinID="string"
    SortParameterName="string"
    SqlCacheDependency="string"
    StartRowIndexParameterName="string"
    TypeName="string"
    UpdateMethod="string"
    Visible="True|False"
>
        <DeleteParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </DeleteParameters>
        <FilterParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </FilterParameters>
        <InsertParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </InsertParameters>
        <SelectParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </SelectParameters>
        <UpdateParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </UpdateParameters>
</asp:ObjectDataSource>

Constructeurs

ObjectDataSource()	Initialise une nouvelle instance de la classe ObjectDataSource.
ObjectDataSource(String, String)	Initialise une nouvelle instance de la classe ObjectDataSource avec le nom du type et le nom de la méthode de récupération de données spécifiés.

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)
BindingContainer	Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control)
CacheDuration	Obtient ou définit la durée, en secondes, de la mise en cache des données par le contrôle de source de données avant que celles-ci soient récupérées par la propriété SelectMethod.
CacheExpirationPolicy	Obtient ou définit le comportement d'expiration du cache qui, lorsqu'il est associé à la durée, décrit le comportement du cache utilisé par le contrôle de source de données.
CacheKeyDependency	Obtient ou définit une dépendance de clé définie par l'utilisateur qui est liée à tous les objets du cache de données créés par le contrôle de source de données.
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)
ConflictDetection	Obtient ou définit une valeur qui détermine si seules les nouvelles valeurs sont passées à la méthode `Update` ou si les anciennes et les nouvelles valeurs sont passées à la méthode `Update`.
Context	Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control)
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)
ConvertNullToDBNull	Obtient ou définit une valeur indiquant si les valeurs Parameter qui sont passées à une opération de mise à jour, d'insertion ou de suppression sont automatiquement converties de la valeur `null` à la valeur Value par le contrôle ObjectDataSource.
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)
DataObjectTypeName	Obtient ou définit le nom d'une classe utilisée par le contrôle ObjectDataSource pour un paramètre dans une opération de mise à jour, d'insertion ou de suppression, au lieu de passer les valeurs individuelles du contrôle lié aux données.
DeleteMethod	Obtient ou définit le nom de la méthode ou de la fonction que le contrôle ObjectDataSource appelle pour supprimer des données.
DeleteParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la méthode DeleteMethod.
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control)
EnableCaching	Obtient ou définit une valeur indiquant si la mise en cache de données du contrôle ObjectDataSource est activée.
EnablePaging	Obtient ou définit une valeur qui indique si le contrôle de source de données prend en charge la pagination du groupe de données qu'il récupère.
EnableTheming	Obtient une valeur indiquant si cet objet prend en charge des thèmes. (Hérité de DataSourceControl)
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)
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)
FilterExpression	Obtient ou définit une expression de filtrage qui est appliquée lorsque la méthode spécifiée par la propriété SelectMethod est appelée.
FilterParameters	Obtient une collection de paramètres qui sont associés aux espaces réservés des paramètres dans la chaîne FilterExpression.
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)
InsertMethod	Obtient ou définit le nom de la méthode ou de la fonction que le contrôle ObjectDataSource appelle pour insérer des données.
InsertParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la propriété InsertMethod.
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)
MaximumRowsParameterName	Obtient ou définit le nom du paramètre de la méthode de récupération de l'objet métier qui est utilisé pour indiquer le nombre d'enregistrements à récupérer pour la prise en charge de la pagination de la source de données.
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)
OldValuesParameterFormatString	Obtient ou définit une chaîne de format à appliquer aux noms des paramètres des valeurs d'origine qui sont passées aux méthodes `Delete` ou `Update`.
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)
ParsingCulture	Obtient ou définit une valeur qui indique les informations culturelles qui sont utilisées lors de la conversion des valeurs de chaînes en types de propriétés réels pour construire un objet du type indiqué par DataObjectTypeName.
RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control)
SelectCountMethod	Obtient ou définit le nom de la méthode ou de la fonction que le contrôle ObjectDataSource appelle pour récupérer un nombre de lignes.
SelectMethod	Obtient ou définit le nom de la méthode ou de la fonction que le contrôle ObjectDataSource appelle pour récupérer des données.
SelectParameters	Obtient une collection des paramètres utilisés par la méthode spécifiée par la propriété SelectMethod.
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)
SortParameterName	Obtient ou définit le nom de l'objet métier utilisé par le paramètre SelectMethod pour spécifier une expression de tri pour la prise en charge du tri de la source de données.
SqlCacheDependency	Obtient ou définit une chaîne délimitée par des points-virgules qui indique les bases de données et les tables à utiliser pour la dépendance de cache Microsoft SQL Server.
StartRowIndexParameterName	Obtient ou définit le nom du paramètre de la méthode de récupération de données utilisé pour indiquer la valeur de l'identificateur du premier enregistrement à récupérer pour la prise en charge de la pagination de la source 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)
TypeName	Obtient ou définit le nom de la classe que l'objet ObjectDataSource représente.
UniqueID	Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control)
UpdateMethod	Obtient ou définit le nom de la méthode ou de la fonction que le contrôle ObjectDataSource appelle pour mettre à jour des données.
UpdateParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la méthode spécifiée par la propriété UpdateMethod.
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)

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)
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()	Exécute une opération de suppression en appelant la méthode identifiée par la propriété DeleteMethod avec tous les paramètres qui figurent dans la collection DeleteParameters.
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)	Récupère la vue de source de données associée au contrôle de source de données.
GetViewNames()	Récupère une collection des noms qui représentent la liste d'objets de vue associée à l'objet ObjectDataSource.
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()	Exécute une opération d'insertion en appelant la méthode qui est identifiée par la propriété InsertMethod et tous les paramètres dans la collection InsertParameters.
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 d'affichage enregistré précédemment du contrôle ObjectDataSource.
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)	Ajoute un gestionnaire d'événements LoadComplete à la page qui contient le contrôle ObjectDataSource.
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. (Hérité de Control)
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)
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 du contrôle ObjectDataSource.
Select()	Récupère les données du stockage de données sous-jacent en appelant la méthode qui est identifiée par la propriété SelectMethod avec les paramètres dans la collection SelectParameters.
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 ObjectDataSource afin de les stocker dans l'objet StateBag.
Update()	Exécute une opération de mise à jour en appelant la méthode identifiée par la propriété UpdateMethod et tous les paramètres qui figurent dans la collection UpdateParameters.

Événements

DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control)
Deleted	Se produit lorsqu'une opération Delete() est terminée.
Deleting	Se produit avant une opération Delete().
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)
Filtering	Se produit avant une opération de filtre.
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 lorsqu'une opération Insert() est terminée.
Inserting	Se produit avant une opération Insert().
Load	Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control)
ObjectCreated	Se produit après la création de l'objet identifié par la propriété TypeName.
ObjectCreating	Se produit avant la création de l'objet identifié par la propriété TypeName.
ObjectDisposing	Se produit avant que l'objet identifié par la propriété TypeName ne soit ignoré.
PreRender	Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control)
Selected	Se produit lorsqu'une opération Select() est terminée.
Selecting	Se produit avant une opération Select().
Unload	Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control)
Updated	Se produit lorsqu'une opération Update() est terminée.
Updating	Se produit avant une opération Update().

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)
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

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é.
TryGetMetaTable(IDataSource, MetaTable)	Détermine si des métadonnées de table sont disponibles.

S’applique à

Partager via