ObjectDataSource Classe
Définition
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 DataSourceControlPublic Class ObjectDataSource
Inherits DataSourceControl- Héritage
- Attributs
Exemples
Cette section montre un ObjectDataSource dans le balisage dans une page .aspx et les objets métier avec tableaux qu’il utilise. 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 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
EmployeeLogicclasse est la classe de logique métier que le ObjectDataSource utilise.La
NorthwindEmployeeclasse définit l’objet de données retourné par laGetAllEmployeesméthode de laEmployeeLogicclasse .
Une classe supplémentaire NorthwindDataException est fournie pour des raisons pratiques.
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
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 des 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 ObjectDataSource le fonctionne. 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 ObjectCreatingdes événements , ObjectCreatedet ObjectDisposing .
Notes
Les méthodes identifiées par les SelectMethodpropriétés , UpdateMethod, InsertMethodet DeleteMethod peuvent être instance méthodes ou static (Shared en Visual Basic). Si les méthodes sont static (Shared en Visual Basic), une instance de l’objet métier n’est pas 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 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 par programmation à 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 à des 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 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 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 lots.
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 propriété sur une expression de filtrage à l’aide FilterExpression 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 le 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é . Lorsque 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 à l’aide SelectMethod 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. met ObjectDataSource automatiquement en cache les données lorsque la EnableCaching propriété a la truevaleur et que 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 les objets qui conservent des ressources ou un état qui ne peuvent pas être partagés pour traiter plusieurs requêtes (par exemple, un objet ouvertSqlDataReader), car le même instance de l’objet sera utilisé pour traiter plusieurs requêtes.
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 collection par programmation ou à l’aide SelectParameters 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 porte 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 des 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 EnableCachingtrue, 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 sur le client ne sont pas converties automatiquement du format de culture client au format de culture du serveur. Par exemple, la culture cliente 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 entré dans un TextBox contrôle au 5/10/2009, mais serait interprété comme le 10 mai 2009. Le 15 octobre 2009 serait entré au 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 d’affichage 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 ObjectDataSourceView effectue toutes les opérations de données, y compris 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 , 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 des 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| FindControl(String, Int32) |
Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l' |
| 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 à
Voir aussi
- IDataSource
- DataSourceControl
- ObjectDataSourceView
- Procédure pas à pas : Liaison de données à un objet métier personnalisé
- Contrôles serveur Web de sources de données
- Vue d'ensemble du contrôle ObjectDataSource
- Création d'un objet source de contrôle ObjectDataSource
- Utilisation d’Entity Framework et du contrôle ObjectDataSource
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour