ObjectDataSource Classe

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 les architectures d’application web multiniveau.

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 affiche un ObjectDataSource balisage dans une page .aspx et affiche les objets métier avec utilisant. 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 pour 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 que le ObjectDataSource contrôle de la page .aspx utilise. (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 utilisée ObjectDataSource .
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 comme commodité.

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
Purpose
Récupération de données
Exécution d’opérations de données
filtrage des données
Mise en cache
Fonctionnalités
Vue de données
Utilisation de LINQ to SQL
Syntaxe déclarative

Présentation

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 les données, et vous fournissez les noms de ces méthodes au contrôle dans le ObjectDataSource balisage. Lors du rendu ou du traitement de publication, les ObjectDataSource appels sont les méthodes que vous avez spécifiées.

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

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 entraîne 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 contrôle utilise la ObjectDataSource réflexion pour créer des instances d’objets métier et appeler des méthodes sur celles-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 l’utilisateur ObjectDataSource . Le ObjectDataSource contrôle crée et détruit une instance de la classe pour chaque appel de méthode ; il ne contient pas l’objet en mémoire pendant 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 est sinon 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 événements , ObjectCreatedet ObjectDisposing des ObjectCreatingévénements.

Note

Les méthodes identifiées par les SelectMethodméthodes , UpdateMethod, InsertMethodet DeleteMethod les propriétés peuvent être des méthodes d’instance ou static (Shared en Visual Basic). Si les méthodes sont static (Shareden Visual Basic), une instance de l’objet métier n’est pas créée, et les ObjectCreating ObjectCreatedévénements et ObjectDisposing les événements 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 un ou DataSet un IEnumerable objet, 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 transmettre à la méthode spécifiée par la SelectMethod propriété. Pour que le ObjectDataSource contrôle utilise les paramètres, les paramètres 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 les 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 propriété. La méthode spécifiée par la SelectMethod propriété est appelée automatiquement par les contrôles liés au ObjectDataSource moment où 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 est automatiquement lié 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

Selon les 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 les mises à jour, les insertions et les suppressions. Pour effectuer ces opérations de données, définissez le nom de méthode approprié 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 des mises à jour et ajoutez 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, explicitement par votre code ou automatiquement par un contrôle lié aux données. Le même modèle général est suivi pour et pour Delete les Insert opérations. 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 ou DataTable en tant qu’objetDataSet. 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 des valeurs dans l’expression aux paramètres spécifiés dans la FilterParameters collection.

Mise en cache

Bien que l’instance ObjectDataSource de l’objet métier ne conserve pas l’instance de l’objet métier sur plusieurs requêtes, elle 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 utilisation de 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. Les ObjectDataSource données sont automatiquement mises en cache lorsque la EnableCaching propriété est définie trueet la CacheDuration propriété est définie sur le nombre de secondes pendant lesquelles le cache stocke les données avant l’abandon du cache. 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 les objets qui conservent les ressources ou l’état qui ne peuvent pas être partagés pour traiter plusieurs requêtes (par exemple, un objet ouvert SqlDataReader ), car la même instance de l’objet sera utilisée pour traiter plusieurs requêtes.

Fonctionnalités

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

Capacité	Exigences
Sélection	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 tous les 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 une DataSet ou DataTable.
Paging	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 respectivement dans les propriétés et StartRowIndexParameterName les MaximumRowsParameterName propriétés. Un contrôle lié aux données peut être en mesure d’effectuer la pagination elle-même, 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é. L’exigence pour que le contrôle lié aux données puisse le faire 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 EnableCaching propriété `true`sur , et les CacheExpirationPolicy CacheDuration propriétés en fonction du comportement de mise en cache souhaité pour vos données mises en cache.

Note

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 du client au format de culture du serveur. Par exemple, la culture du client peut spécifier DD/MM/AAAA comme format de date, et le format de date sur le serveur peut être MM/DD/AAAA. Dans ce cas, le 5 octobre 2009 serait entré dans un TextBox contrôle comme 5/10/2009, mais serait interprété comme le 10 mai 2009. Le 15 octobre 2009 serait entré comme 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 utilisée par le développeur de pages pour travailler avec 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 ObjectDataSourceView effectue toutes les opérations de données, notamment la récupération, l’insertion, la mise à jour, la suppression, le 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 , et DeleteMethod UpdateMethod InsertMethodles méthodes dans 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 How to : Create LINQ to SQL Classes in a Web Project. 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

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

Propriétés

Nom	Description
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 du ou UserControl de l’objet Page 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, que le contrôle de source de données met en cache les données récupérées par la SelectMethod propriété.
CacheExpirationPolicy	Obtient ou définit le comportement d’expiration du cache qui, lorsqu’il est combiné à la durée, décrit le comportement du cache que le contrôle de source de données utilise.
CacheKeyDependency	Obtient ou définit une dépendance de clé définie par l’utilisateur liée à tous les objets de cache de données créés par le contrôle de source de données.
ChildControlsCreated	Obtient une valeur qui indique si les 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 séparateur utilisé dans la ClientID propriété. (Hérité de Control)
ConflictDetection	Obtient ou définit une valeur qui détermine si les nouvelles valeurs sont transmises à la `Update` méthode ou non, ou les anciennes et nouvelles valeurs sont passées à la `Update` méthode.
Context	Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control)
Controls	Obtient un ControlCollection objet qui représente les contrôles enfants d’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 Parameter valeurs passées à une opération de mise à jour, d’insertion ou de suppression sont automatiquement converties en `null` valeur par le Value ObjectDataSource contrôle.
DataItemContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control)
DataKeysContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control)
DataObjectTypeName	Obtient ou définit le nom d’une classe utilisée par le ObjectDataSource contrôle pour un paramètre dans une opération de mise à jour, d’insertion ou de suppression de données, au lieu de passer des valeurs individuelles du contrôle lié aux données.
DeleteMethod	Obtient ou définit le nom de la méthode ou de la fonction appelée par le ObjectDataSource contrôle pour supprimer des données.
DeleteParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la DeleteMethod méthode.
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control)
EnableCaching	Obtient ou définit une valeur indiquant si la mise en cache des données est activée pour le ObjectDataSource contrôle.
EnablePaging	Obtient ou définit une valeur qui indique si le contrôle de source de données prend en charge la pagination via le jeu de données qu’il récupère.
EnableTheming	Obtient une valeur indiquant si ce contrôle prend en charge les 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 des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control)
Events	Obtient une liste de délégués de gestionnaire 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 appliquée lorsque la méthode spécifiée par la SelectMethod propriété est appelée.
FilterParameters	Obtient une collection de paramètres associés à tous les espaces réservés de paramètres dans la FilterExpression chaîne.
HasChildViewState	Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control)
ID	Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control)
IdSeparator	Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control)
InsertMethod	Obtient ou définit le nom de la méthode ou de la fonction appelée par le ObjectDataSource contrôle pour insérer des données.
InsertParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la InsertMethod propriété.
IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de 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 ID au lieu de l’index. (Hérité de Control)
MaximumRowsParameterName	Obtient ou définit le nom du paramètre de méthode de récupération des données d’objet métier utilisé pour indiquer le nombre d’enregistrements à récupérer pour la prise en charge de la pagination de source de données.
NamingContainer	Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control)
OldValuesParameterFormatString	Obtient ou définit une chaîne de format à appliquer aux noms des paramètres des valeurs d’origine passées aux méthodes ou `Update` aux `Delete` méthodes.
Page	Obtient une référence à l’instance 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 page. (Hérité de Control)
ParsingCulture	Obtient une ou définit une valeur qui indique quelles informations de culture sont utilisées lors de la conversion de valeurs de chaîne en types de propriétés réels afin de construire un objet du type indiqué par DataObjectTypeName.
RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control)
SelectCountMethod	Obtient ou définit le nom de la méthode ou de la fonction appelée par le ObjectDataSource contrôle pour récupérer un nombre de lignes.
SelectMethod	Obtient ou définit le nom de la méthode ou de la fonction appelée par le ObjectDataSource contrôle pour récupérer des données.
SelectParameters	Obtient une collection de paramètres utilisés par la méthode spécifiée par la SelectMethod propriété.
Site	Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control)
SkinID	Obtient la peau à appliquer au DataSourceControl contrôle. (Hérité de DataSourceControl)
SortParameterName	Obtient ou définit le nom de l’objet métier utilisé SelectMethod pour spécifier une expression de tri pour la prise en charge du tri de 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 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 UserControl ou qui contient le contrôle serveur actuel. (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é hiérarchiquement pour le contrôle serveur. (Hérité de Control)
UpdateMethod	Obtient ou définit le nom de la méthode ou de la fonction que le ObjectDataSource contrôle appelle pour mettre à jour les 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 UpdateMethod propriété.
ValidateRequestMode	Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des 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 sur plusieurs requêtes pour la même page. (Hérité de Control)
ViewStateIgnoresCase	Obtient une valeur qui indique si l’objet ne respecte pas la StateBag 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 si le contrôle est affiché visuellement. (Hérité de DataSourceControl)

Méthodes

Nom	Description
AddedControl(Control, Int32)	Appelé après l’ajout d’un contrôle enfant à la Controls collection 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 du ControlCollection contrôle serveur. (Hérité de Control)
ApplyStyleSheetSkin(Page)	Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Commence le suivi 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 le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control)
ClearCachedClientID()	Définit la valeur mise en ClientID cache sur `null`. (Hérité de Control)
ClearChildControlState()	Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildState()	Supprime les informations d’état d’affichage et d’état de contrôle pour 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()	Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control)
CreateChildControls()	Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu. (Hérité de Control)
CreateControlCollection()	Crée une collection pour stocker les 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()	Effectue une opération de suppression en appelant la méthode identifiée par la DeleteMethod propriété avec tous les paramètres qui se trouvent dans la DeleteParameters collection.
Dispose()	Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control)
EndRenderTracing(TextWriter, Object)	Met fin au suivi 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. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control)
EnsureID()	Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FindControl(String, Int32)	Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié `id` et spécifié dans le `pathOffset` paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode. (Hérité de Control)
FindControl(String)	Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié `id` . (Hérité de DataSourceControl)
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()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetRouteUrl(Object)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(String, Object)	Obtient l’URL qui correspond à un ensemble 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 ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetUniqueIDRelativeTo(Control)	Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié. (Hérité de Control)
GetView(String)	Récupère la vue de source de données nommée associée au contrôle de source de données.
GetViewNames()	Récupère une collection de noms représentant la liste des objets d’affichage associés à 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 les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control)
Insert()	Effectue une opération d’insertion en appelant la méthode identifiée par la InsertMethod propriété et tous les paramètres de la InsertParameters collection.
IsLiteralContent()	Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control)
LoadControlState(Object)	Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control)
LoadViewState(Object)	Charge l’état d’affichage précédemment enregistré du ObjectDataSource contrôle.
MapPathSecure(String)	Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnBubbleEvent(Object, EventArgs)	Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’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 ObjectDataSource contrôle.
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 élément utilisé pour lire un fichier. (Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)	Affecte toutes les sources 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)	Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control)
Render(HtmlTextWriter)	Envoie le contenu du contrôle serveur à un objet fourni HtmlTextWriter , qui écrit le contenu à afficher sur le client. (Hérité de Control)
RenderChildren(HtmlTextWriter)	Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control)
RenderControl(HtmlTextWriter)	Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de DataSourceControl)
ResolveAdapter()	Obtient l’adaptateur de contrôle 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 utilisable sur le client demandeur. (Hérité de Control)
SaveControlState()	Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control)
SaveViewState()	Enregistre l’état du ObjectDataSource contrôle.
Select()	Récupère les données du stockage de données sous-jacent en appelant la méthode identifiée par la SelectMethod propriété avec les paramètres de la SelectParameters collection.
SetDesignModeState(IDictionary)	Définit les données au moment du design pour un contrôle. (Hérité de Control)
SetRenderMethodDelegate(RenderMethod)	Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control)
SetTraceData(Object, Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control)
SetTraceData(Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de 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()	Effectue le suivi des modifications de l’état d’affichage du ObjectDataSource contrôle afin qu’elles puissent être stockées dans l’objet StateBag .
Update()	Effectue une opération de mise à jour en appelant la méthode identifiée par la UpdateMethod propriété et tous les paramètres qui se trouvent dans la UpdateParameters collection.

Événements

Nom	Description
DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control)
Deleted	Se produit lorsqu’une Delete() opération est terminée.
Deleting	Se produit avant une Delete() opération.
Disposed	Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control)
Filtering	Se produit avant une opération de filtre.
Init	Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control)
Inserted	Se produit lorsqu’une Insert() opération est terminée.
Inserting	Se produit avant une Insert() opération.
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 TypeName propriété.
ObjectCreating	Se produit avant la création de l’objet identifié par la TypeName propriété.
ObjectDisposing	Se produit avant que l’objet identifié par la TypeName propriété 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 Select() opération est terminée.
Selecting	Se produit avant une Select() opération.
Unload	Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control)
Updated	Se produit lorsqu’une Update() opération est terminée.
Updating	Se produit avant une Update() opération.

Implémentations d’interfaces explicites

Nom	Description
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 source de données a changé d’une manière qui affecte les contrôles liés aux données. (Hérité de DataSourceControl)
IDataSource.GetView(String)	Obtient l’objet nommé DataSourceView associé au DataSourceControl contrôle. Certains contrôles de source de données ne prennent en charge qu’une seule vue, tandis que d’autres prennent en charge plusieurs. (Hérité de DataSourceControl)
IDataSource.GetViewNames()	Obtient une collection de noms, représentant la liste des DataSourceView objets associés au DataSourceControl contrôle. (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 source de données est associé à une ou plusieurs listes de données. (Hérité de DataSourceControl)
IListSource.GetList()	Obtient une liste de contrôles de source de données qui peuvent être utilisés comme sources de 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

Nom	Description
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 de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié.
FindMetaTable(Control)	Retourne l’objet métatable pour le contrôle de données contenant.
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 d’une table dans l’objet de source de données spécifié.
TryGetMetaTable(IDataSource, MetaTable)	Détermine si les métadonnées de table sont disponibles.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?