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 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 DataSourceControlPublic Class ObjectDataSource
Inherits DataSourceControl- Héritage
- Attributs
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
EmployeeLogicclasse est la classe logique métier utilisée ObjectDataSource .La
NorthwindEmployeeclasse définit l’objet de données retourné par laGetAllEmployeesméthode de laEmployeeLogicclasse.
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 :
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 ObjectCreatingObjectCreatedé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é truesur , et les CacheExpirationPolicyCacheDuration 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 DeleteMethodUpdateMethodInsertMethodles 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 |
| 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 |
| 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 |
| 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 PageUserControl 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 |
| 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é |
| FindControl(String) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié |
| 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
- IDataSource
- DataSourceControl
- ObjectDataSourceView
- Procédure pas à pas : liaison de données à un objet métier personnalisé
- Contrôles serveur web de source de données
- Vue d’ensemble du contrôle ObjectDataSource
- Création d’un objet source de contrôle ObjectDataSource
- Utilisation de Entity Framework et du contrôle ObjectDataSource
