Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ObjectDataSource classe

 

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

Espace de noms:   System.Web.UI.WebControls
Assembly:  System.Web (dans System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.DataSourceControl
      System.Web.UI.WebControls.ObjectDataSource

[ToolboxBitmapAttribute(typeof(ObjectDataSource))]
public class ObjectDataSource : DataSourceControl

NomDescription
System_CAPS_pubmethodObjectDataSource()

Initialise une nouvelle instance de la classe ObjectDataSource.

System_CAPS_pubmethodObjectDataSource(String, String)

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

NomDescription
System_CAPS_protpropertyAdapter

Obtient l’adaptateur spécifique au navigateur pour le contrôle.(Hérité de Control.)

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l’application de la Page ou UserControl objet qui contient ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyBindingContainer

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient le contrôle qui contient la liaison de données de ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyCacheDuration

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é.

System_CAPS_pubpropertyCacheExpirationPolicy

Obtient ou définit le comportement d’expiration du cache qui, lorsqu’elles sont combinées avec la durée, décrit le comportement du cache qui utilise le contrôle de source de données.

System_CAPS_pubpropertyCacheKeyDependency

Obtient ou définit une dépendance de clé définie par l’utilisateur qui est liée à toutes les données de cache des objets qui sont créés par le contrôle de source de données.

System_CAPS_protpropertyChildControlsCreated

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés.(Hérité de Control.)

System_CAPS_pubpropertyClientID

Obtient l’identificateur du contrôle serveur généré par ASP.NET.(Hérité de DataSourceControl.)

System_CAPS_pubpropertyClientIDMode

Cette propriété n’est pas utilisée pour les contrôles de source de données.(Hérité de DataSourceControl.)

System_CAPS_protpropertyClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans le ClientID propriété.(Hérité de Control.)

System_CAPS_pubpropertyConflictDetection

Obtient ou définit une valeur qui détermine si seules les nouvelles valeurs sont passés à la Update méthode ou les valeurs anciennes et nouvelles sont passés à la Update (méthode).

System_CAPS_protpropertyContext

Obtient le HttpContext est associé au contrôle serveur pour la demande Web actuelle.(Hérité de Control.)

System_CAPS_pubpropertyControls

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

System_CAPS_pubpropertyConvertNullToDBNull

Obtient ou définit une valeur indiquant si le Parameter les valeurs qui sont passées à une mise à jour, d’insertion ou opération de suppression sont automatiquement converties de null à la Value valeur par le ObjectDataSource contrôle.

System_CAPS_pubpropertyDataItemContainer

Obtient une référence au conteneur d’attribution de noms si celui-ci implémente IDataItemContainer.(Hérité de Control.)

System_CAPS_pubpropertyDataKeysContainer

Obtient une référence au conteneur d’attribution de noms si celui-ci implémente IDataKeysControl.(Hérité de Control.)

System_CAPS_pubpropertyDataObjectTypeName

Obtient ou définit le nom d’une classe qui le ObjectDataSource contrôle utilise pour un paramètre dans une mise à jour, insérer ou supprimer l’opération de données, au lieu de passer les valeurs individuelles du contrôle lié aux données.

System_CAPS_pubpropertyDeleteMethod

Obtient ou définit le nom de la méthode ou fonction que le ObjectDataSource contrôle appelle pour supprimer des données.

System_CAPS_pubpropertyDeleteParameters

Obtient la collection de paramètres qui contient les paramètres utilisés par le DeleteMethod (méthode).

System_CAPS_protpropertyDesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.(Hérité de Control.)

System_CAPS_pubpropertyEnableCaching

Obtient ou définit une valeur indiquant si le ObjectDataSource contrôle est mise en cache de données activée.

System_CAPS_pubpropertyEnablePaging

Obtient ou définit une valeur qui indique si le contrôle de source de données prend en charge la pagination de l’ensemble des données qu’il récupère.

System_CAPS_pubpropertyEnableTheming

Obtient une valeur indiquant si ce contrôle prend en charge les thèmes.(Hérité de DataSourceControl.)

System_CAPS_pubpropertyEnableViewState

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

System_CAPS_protpropertyEvents

Obtient une liste de délégués de gestionnaires d’événements pour le contrôle. Cette propriété est en lecture seule.(Hérité de Control.)

System_CAPS_pubpropertyFilterExpression

Obtient ou définit une expression de filtrage qui est appliquée lorsque la méthode qui est spécifiée par le SelectMethod propriété est appelée.

System_CAPS_pubpropertyFilterParameters

Obtient une collection de paramètres qui sont associés à des espaces réservés de paramètre dans le FilterExpression chaîne.

System_CAPS_protpropertyHasChildViewState

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur actuel ont tous les paramètres d’état d’affichage enregistrés.(Hérité de Control.)

System_CAPS_pubpropertyID

Obtient ou définit l’identificateur programmatique assigné au contrôle serveur.(Hérité de Control.)

System_CAPS_protpropertyIdSeparator

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient le caractère utilisé pour séparer les identificateurs de contrôle.(Hérité de Control.)

System_CAPS_pubpropertyInsertMethod

Obtient ou définit le nom de la méthode ou fonction que le ObjectDataSource contrôle appelle pour insérer des données.

System_CAPS_pubpropertyInsertParameters

Obtient la collection de paramètres qui contient les paramètres utilisés par le InsertMethod propriété.

System_CAPS_protpropertyIsChildControlStateCleared

Obtient une valeur qui indique si les contrôles contenus dans ce contrôle ont état du contrôle.(Hérité de Control.)

System_CAPS_protpropertyIsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage.(Hérité de Control.)

System_CAPS_protpropertyIsViewStateEnabled

Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle.(Hérité de Control.)

System_CAPS_protpropertyLoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage par ID au lieu de l’index.(Hérité de Control.)

System_CAPS_pubpropertyMaximumRowsParameterName

Obtient ou définit le nom de l’entreprise objet données récupération de paramètre de méthode qui est utilisé pour indiquer le nombre d’enregistrements à récupérer pour la prise en charge la pagination de données source.

System_CAPS_pubpropertyNamingContainer

Obtient une référence au contrôle de serveur de noms de conteneur, ce qui crée un espace de noms unique pour différencier les contrôles serveur avec le même Control.ID valeur de propriété.(Hérité de Control.)

System_CAPS_pubpropertyOldValuesParameterFormatString

Obtient ou définit une chaîne de format à appliquer aux noms des paramètres pour les valeurs d’origine qui sont passées à la Delete ou Update méthodes.

System_CAPS_pubpropertyPage

Obtient une référence à la Page instance qui contient le contrôle serveur.(Hérité de Control.)

System_CAPS_pubpropertyParent

Obtient une référence au contrôle parent du contrôle de serveur dans la hiérarchie de contrôle de page.(Hérité de Control.)

System_CAPS_pubpropertyParsingCulture

Obtient un ou définit une valeur qui indique les informations de culture sont utilisées lors de la conversion des valeurs de chaîne aux types de propriété réelle pour construire un objet du type indiqué par DataObjectTypeName.

System_CAPS_pubpropertyRenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET HTML restitué sera compatible avec.(Hérité de Control.)

System_CAPS_pubpropertySelectCountMethod

Obtient ou définit le nom de la méthode ou fonction que le ObjectDataSource contrôle appelle pour récupérer un nombre de lignes.

System_CAPS_pubpropertySelectMethod

Obtient ou définit le nom de la méthode ou fonction que le ObjectDataSource contrôle appelle pour récupérer des données.

System_CAPS_pubpropertySelectParameters

Obtient une collection de paramètres qui sont utilisés par la méthode spécifiée par la SelectMethod propriété.

System_CAPS_pubpropertySite

Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une aire de conception.(Hérité de Control.)

System_CAPS_pubpropertySkinID

Obtient l’apparence à appliquer à la DataSourceControl contrôle.(Hérité de DataSourceControl.)

System_CAPS_pubpropertySortParameterName

Obtient ou définit le nom de l’objet métier que le SelectMethod paramètre permet de spécifier une expression de tri pour la prise en charge de tri de source de données.

System_CAPS_pubpropertySqlCacheDependency

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.

System_CAPS_pubpropertyStartRowIndexParameterName

Obtient ou définit le nom du paramètre de méthode de récupération de données qui est utilisé pour indiquer la valeur de l’identificateur du premier enregistrement à récupérer pour la prise en charge la pagination de données source.

System_CAPS_pubpropertyTemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Obtient le répertoire virtuel de le Page ou UserControl qui contient le contrôle serveur en cours.(Hérité de Control.)

System_CAPS_pubpropertyTypeName

Obtient ou définit le nom de la classe qui le ObjectDataSource de l’objet représente.

System_CAPS_pubpropertyUniqueID

Obtient l’identificateur unique qualifié hiérarchiquement du contrôle serveur.(Hérité de Control.)

System_CAPS_pubpropertyUpdateMethod

Obtient ou définit le nom de la méthode ou fonction que le ObjectDataSource contrôle appelle pour mettre à jour des données.

System_CAPS_pubpropertyUpdateParameters

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é.

System_CAPS_pubpropertyValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie les entrées de client à partir du navigateur de valeurs potentiellement dangereuses.(Hérité de Control.)

System_CAPS_protpropertyViewState

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

System_CAPS_protpropertyViewStateIgnoresCase

Obtient une valeur qui indique si le StateBag objet respecte la casse.(Hérité de Control.)

System_CAPS_pubpropertyViewStateMode

Obtient ou définit le mode d’état d’affichage de ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyVisible

Obtient ou définit une valeur indiquant si le contrôle est affiché visuellement.(Hérité de DataSourceControl.)

NomDescription
System_CAPS_protmethodAddedControl(Control, Int32)

Appelée après qu’un contrôle enfant est ajouté à la Controls collection de le Control objet.(Hérité de Control.)

System_CAPS_protmethodAddParsedSubObject(Object)

Notifie au 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.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Applique les propriétés de style qui sont définies dans la feuille de style de page pour le contrôle.(Hérité de DataSourceControl.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Commence le suivi au moment du design de données de rendu.(Hérité de Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Rassemble des informations sur le contrôle serveur, puis les remet à la Trace propriété à afficher lorsque le traçage est activé pour la page.(Hérité de Control.)

System_CAPS_protmethodClearCachedClientID()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit la mise en cache ClientID valeur null.(Hérité de Control.)

System_CAPS_protmethodClearChildControlState()

Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur.(Hérité de Control.)

System_CAPS_protmethodClearChildState()

Supprime les informations d’état d’affichage et état du contrôle pour tous les contrôles du contrôle serveur enfant.(Hérité de Control.)

System_CAPS_protmethodClearChildViewState()

Supprime les informations d’état d’affichage pour tous les contrôles du contrôle serveur enfant.(Hérité de Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit le ClientIDMode propriété de l’instance actuelle du contrôle et de ses contrôles enfants à Inherit.(Hérité de Control.)

System_CAPS_protmethodCreateChildControls()

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

System_CAPS_protmethodCreateControlCollection()

Crée une collection pour stocker des contrôles enfants.(Hérité de DataSourceControl.)

System_CAPS_pubmethodDataBind()

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

System_CAPS_protmethodDataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher la DataBinding événement.(Hérité de Control.)

System_CAPS_protmethodDataBindChildren()

Lie une source de données à des contrôles enfants du contrôle serveur.(Hérité de Control.)

System_CAPS_pubmethodDelete()

Effectue une opération de suppression en appelant la méthode qui est identifiée par le DeleteMethod propriété avec tous les paramètres qui se trouvent dans le DeleteParameters collection.

System_CAPS_pubmethodDispose()

Permet à un contrôle serveur effectuer de nettoyage final avant qu’il est libéré de la mémoire.(Hérité de Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Se termine au moment du design le suivi des données de rendu.(Hérité de Control.)

System_CAPS_protmethodEnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. Si elle n’est pas le cas, il crée contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodEnsureID()

Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté.(Hérité de Control.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodFindControl(String)

Recherche le conteneur d’attribution de noms actuel d’un contrôle serveur avec l’objet id paramètre.(Hérité de DataSourceControl.)

System_CAPS_protmethodFindControl(String, Int32)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Recherche le conteneur d’attribution de noms actuel d’un contrôle serveur avec l’objet id et un entier, spécifié dans le pathOffset paramètre, ce qui facilite la recherche. Vous ne devez pas substituer cette version de la FindControl méthode.(Hérité de Control.)

System_CAPS_pubmethodFocus()

Définit le focus d'entrée sur le contrôle.(Hérité de DataSourceControl.)

System_CAPS_protmethodGetDesignModeState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient les données au moment du design pour un contrôle.(Hérité de Control.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetRouteUrl(Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(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.)

System_CAPS_pubmethodGetRouteUrl(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.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié.(Hérité de Control.)

System_CAPS_protmethodGetView(String)

Récupère la vue de source de données nommée qui est associée au contrôle de source de données.(Remplace DataSourceControl.GetView(String).)

System_CAPS_protmethodGetViewNames()

Récupère une collection de noms représentant la liste des objets de vue qui sont associés les ObjectDataSource objet.(Remplace DataSourceControl.GetViewNames().)

System_CAPS_pubmethodHasControls()

Détermine si le contrôle serveur contient des contrôles enfants.(Hérité de DataSourceControl.)

System_CAPS_protmethodHasEvents()

Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou tous les contrôles enfants.(Hérité de Control.)

System_CAPS_pubmethodInsert()

Effectue une opération d’insertion en appelant la méthode qui est identifiée par le InsertMethod propriété et des paramètres de la InsertParameters collection.

System_CAPS_protmethodIsLiteralContent()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Détermine si le contrôle serveur détient uniquement un contenu littéral.(Hérité de Control.)

System_CAPS_protmethodLoadControlState(Object)

Restaure les informations d’état du contrôle à partir d’une demande de page précédente enregistrée par la SaveControlState méthode.(Hérité de Control.)

System_CAPS_protmethodLoadViewState(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Charge l'état d'affichage enregistré précédemment du contrôle ObjectDataSource.(Remplace Control.LoadViewState(Object).)

System_CAPS_protmethodMapPathSecure(String)

Récupère le chemin d’accès physique correspondant à un chemin d’accès virtuel, absolu ou relatif.(Hérité de Control.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnBubbleEvent(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.)

System_CAPS_protmethodOnDataBinding(EventArgs)

Déclenche l'événement DataBinding.(Hérité de Control.)

System_CAPS_protmethodOnInit(EventArgs)

Ajoute un LoadComplete Gestionnaire d’événements à la page qui contient le ObjectDataSource contrôle.(Remplace Control.OnInit(EventArgs).)

System_CAPS_protmethodOnLoad(EventArgs)

Déclenche l'événement Load.(Hérité de Control.)

System_CAPS_protmethodOnPreRender(EventArgs)

Déclenche l'événement PreRender.(Hérité de Control.)

System_CAPS_protmethodOnUnload(EventArgs)

Déclenche l'événement Unload.(Hérité de Control.)

System_CAPS_protmethodOpenFile(String)

Obtient un Stream utilisé pour lire un fichier.(Hérité de Control.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Assigne toute source de l’événement et ses informations au parent du contrôle.(Hérité de Control.)

System_CAPS_protmethodRaiseDataSourceChangedEvent(EventArgs)

Déclenche l'événement DataSourceChanged.(Hérité de DataSourceControl.)

System_CAPS_protmethodRemovedControl(Control)

Appelée après qu’un contrôle enfant est supprimé de la Controls collection de le Control objet.(Hérité de Control.)

System_CAPS_protmethodRender(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter, qui écrit le contenu à rendre sur le client.(Hérité de Control.)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Renvoie le contenu des enfants d’un contrôle serveur à une collection HtmlTextWriter objet, qui écrit le contenu à rendre sur le client.(Hérité de Control.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Renvoie le contenu du contrôle serveur à un HtmlTextWriter de l’objet et stocke les informations de traçage sur le contrôle si le traçage est activé.(Hérité de DataSourceControl.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Renvoie le contenu du contrôle serveur à un HtmlTextWriter à l’aide d’un ControlAdapter objet.(Hérité de Control.)

System_CAPS_protmethodResolveAdapter()

Obtient l’adaptateur de contrôles responsable du rendu du contrôle spécifié.(Hérité de Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.(Hérité de Control.)

System_CAPS_pubmethodResolveUrl(String)

Convertit une URL qui est utilisable sur le client demandeur.(Hérité de Control.)

System_CAPS_protmethodSaveControlState()

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

System_CAPS_protmethodSaveViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Enregistre l'état du contrôle ObjectDataSource.(Remplace Control.SaveViewState().)

System_CAPS_pubmethodSelect()

Récupère des données à partir du stockage de données sous-jacent en appelant la méthode qui est identifiée par le SelectMethod propriété avec les paramètres de le SelectParameters collection.

System_CAPS_protmethodSetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.(Hérité de Control.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Assigne un délégué de gestionnaire d’événements pour afficher le contrôle de serveur et son contenu dans son contrôle parent.(Hérité de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Définit les données de conception suivi de données de rendu, à l’aide de la clé de données de suivi et la valeur de données de suivi de trace.(Hérité de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Définit les données de conception suivi de données de rendu, à l’aide de l’objet de suivi, la clé de données de suivi et la valeur de données de suivi de trace.(Hérité de Control.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodTrackViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Effectue le suivi des modifications d’état d’affichage du ObjectDataSource contrôler afin qu’elles puissent être stockées dans le System.Web.UI.StateBag objet.(Remplace Control.TrackViewState().)

System_CAPS_pubmethodUpdate()

Exécute une opération de mise à jour en appelant la méthode qui est identifiée par le UpdateMethod propriété et des paramètres qui se trouvent dans le UpdateParameters collection.

NomDescription
System_CAPS_pubeventDataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.(Hérité de Control.)

System_CAPS_pubeventDeleted

Se produit lorsqu’une Delete opération terminée.

System_CAPS_pubeventDeleting

Se produit avant une Delete opération.

System_CAPS_pubeventDisposed

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 serveur contrôle lorsqu’une page ASP.NET est demandée.(Hérité de Control.)

System_CAPS_pubeventFiltering

Se produit avant une opération de filtre.

System_CAPS_pubeventInit

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape du cycle de vie.(Hérité de Control.)

System_CAPS_pubeventInserted

Se produit lorsqu’une Insert opération terminée.

System_CAPS_pubeventInserting

Se produit avant une Insert opération.

System_CAPS_pubeventLoad

Se produit lorsque le contrôle serveur est chargé dans le Page objet.(Hérité de Control.)

System_CAPS_pubeventObjectCreated

Se produit après que l’objet qui est identifié par le TypeName propriété est créée.

System_CAPS_pubeventObjectCreating

Se produit avant que l’objet qui est identifié par le TypeName propriété est créée.

System_CAPS_pubeventObjectDisposing

Se produit avant que l’objet qui est identifié par le TypeName propriété est ignorée.

System_CAPS_pubeventPreRender

Se produit après le Control objet est chargé, mais avant le rendu.(Hérité de Control.)

System_CAPS_pubeventSelected

Se produit lorsqu’une Select opération terminée.

System_CAPS_pubeventSelecting

Se produit avant une Select opération.

System_CAPS_pubeventUnload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.(Hérité de Control.)

System_CAPS_pubeventUpdated

Se produit lorsqu’une Update opération terminée.

System_CAPS_pubeventUpdating

Se produit avant une Update opération.

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_priveventIDataSource.DataSourceChanged

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Se produit lorsqu’un contrôle de source de données a changé d’une manière qui affecte des contrôles liés aux données.(Hérité de DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIListSource.GetList()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. 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.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataSource.GetView(String)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient l’index nommé DataSourceView objet associé à le DataSourceControl contrôle. Certains contrôles de source de données prend en charge qu’un affichage, tandis que d’autres prennent en charge plusieurs fois.(Hérité de DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataSource.GetViewNames()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient une collection de noms, représentant la liste des DataSourceView associés à la DataSourceControl contrôle.(Hérité de DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIListSource.ContainsListCollection

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Indique si le contrôle de source de données est associé à une ou plusieurs listes de données.(Hérité de DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions.(Hérité de Control.)

NomDescription
System_CAPS_pubmethodFindDataSourceControl()

Retourne la source de données qui est associée au contrôle de données pour le contrôle spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Retourne que le modèle de champ pour la colonne spécifiée dans le contrôle spécifié du conteneur de dénomination.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Retourne l’objet metatable pour le contrôle de données conteneur.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodGetDefaultValues()

Surchargé. Obtient la collection des valeurs par défaut pour la source de données spécifiée.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodGetMetaTable()

Surchargé. Obtient les métadonnées pour une table dans l’objet de source de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodTryGetMetaTable(MetaTable)

Surchargé. Détermine si les métadonnées de la table sont disponible.(Défini par DynamicDataExtensions.)

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

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

Une pratique de conception d’application très courante consiste à séparer la couche de présentation de 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 présentation et la couche données, ce qui entraîne une architecture à trois couches application. 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 d’appeler des méthodes sur ces derniers à récupérer, mettre à jour, insérer et supprimer des données. Le TypeName propriété identifie le nom de la classe qui le ObjectDataSource fonctionne avec. Le ObjectDataSource contrôle crée et détruit une instance de la classe pour chaque appel de méthode ; il ne maintient pas l’objet en mémoire pour la durée de vie de la demande Web. Il s’agit d’un facteur important si l’objet métier que vous utilisez requiert beaucoup de ressources ou qu’il est coûteux créer et détruire. À l’aide d’un objet coûteux ne peut pas être un choix de conception optimal, mais vous pouvez contrôler le cycle de vie de l’objet à l’aide de la ObjectCreating, ObjectCreated, et ObjectDisposing événements.

System_CAPS_noteRemarque

Les méthodes qui sont identifiées par le SelectMethod, UpdateMethod, InsertMethod, et DeleteMethod propriétés peuvent être des méthodes d’instance ou static (Shared en Visual Basic) méthodes. Si les méthodes sont static (Shared en Visual Basic), une instance de l’objet métier n’est pas créée et le ObjectCreating, ObjectCreated, et ObjectDisposing ne sont pas déclenchés.

Pour récupérer des données à partir d’un objet métier, affectez le SelectMethod nom à la propriété de la méthode qui Récupère des données. Si la méthode ne retourne pas une IEnumerable ou DataSet de l’objet, l’objet est encapsulé par l’exécution dans un IEnumerable collection. Si la signature de méthode a des paramètres, vous pouvez ajouter Parameter des objets sur le SelectParameters collection, puis des lier aux valeurs que vous souhaitez passer à la méthode spécifiée par la SelectMethod propriété. Dans l’ordre pour les ObjectDataSource pour utiliser les paramètres de contrôle, les paramètres doivent correspondre les noms et types des paramètres dans la signature de méthode. Pour plus d'informations, consultez Using Parameters with the ObjectDataSource Control.

Le ObjectDataSource contrôle récupère des données chaque fois que le Select méthode est appelée. Cette méthode fournit un accès par programmation à la méthode spécifiée par SelectMethod propriété. La méthode qui est spécifiée par le SelectMethod propriété est appelée automatiquement par les contrôles qui sont liés à la ObjectDataSource lors de leur DataBind méthode est appelée. Si vous définissez le DataSourceID propriété d’un contrôle lié aux données, le contrôle automatiquement lié aux données à partir de la source de données, en fonction des besoins. Définition de la DataSourceID propriété est la méthode recommandée pour la liaison un ObjectDataSource vers un contrôle lié aux données. Vous pouvez également définir le DataSource propriété mais que 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 de données à l’aide d’un contrôle de Source de données.

En fonction des capacités de l’entreprise de l’objet qui le ObjectDataSource associé au contrôle, vous pouvez effectuer des opérations de données, telles que les mises à jour, insertions et suppressions. Pour effectuer ces opérations de données, définissez le nom de la méthode appropriée et 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é le nom de la méthode d’objet métier qui effectue des mises à jour et ajouter 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ètre de la méthode correspondent au nom de champ 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, ou automatiquement par un contrôle lié aux données. Le même modèle général est suivi de Delete et Insert operations. Les objets métier sont supposés pour exécuter ces types d’un enregistrement des opérations de données à la fois, plutôt que par lots.

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

Bien que le ObjectDataSource ne conserve pas l’instance de l’objet métier dans plusieurs requêtes, il peut mettre en cache le résultat de l’appel de la méthode identifiée par le SelectMethod propriété. Alors que les données sont mises en cache, les appels suivants à la Select méthode retourne les données mises en cache au lieu de créer l’objet métier et en appelant son SelectMethod à l’aide de la réflexion. La mise en cache vous permet de vous éviter de créer l’objet et en appelant sa méthode de données au détriment de la mémoire sur le serveur Web. Le ObjectDataSource met automatiquement en cache les données lorsque le EnableCaching est définie sur trueet le CacheDuration est définie sur le nombre de secondes pendant lesquelles le cache stocke les données avant que le cache est ignoré. Vous pouvez également spécifier un CacheExpirationPolicy propriété et éventuellement un SqlCacheDependency propriété. 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 un état qui ne peut pas être partagé pour plusieurs demandes de service (par exemple, open SqlDataReader objet), comme la même instance de l’objet est utilisée à plusieurs demandes de service.

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

Fonctionnalité

Spécifications

Sélection

Définir le SelectMethod méthode qui sélectionne les données de l’objet nom à la propriété de l’entreprise et inclure tous les paramètres nécessaires dans la SelectParameters collection par programme ou à l’aide d’un contrôle lié aux données.

Tri

Définir le SortParameterName propriété le nom du paramètre dans le SelectMethod méthode qui exécute les critères de tri.

Filtrage

Définir le FilterExpression propriété à une expression de filtrage et éventuellement ajouter tous les paramètres de la FilterParameters collection pour filtrer les données lors de 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 le MaximumRowsParameterName et StartRowIndexParameterName propriétés, respectivement. Un contrôle lié aux données peut être en mesure d’effectuer la pagination lui-même, même si le ObjectDataSource contrôle ne prend pas en charge la pagination directement dans la méthode spécifiée par la SelectMethod propriété. La configuration requise pour le contrôle lié aux données être en mesure de procéder est que la méthode spécifiée par la SelectMethod propriété renvoie un objet qui implémente le ICollection interface.

Mise à jour

Définir le UpdateMethod méthode qui met à jour les données de l’objet nom à la propriété de l’entreprise et inclure tous les paramètres nécessaires dans la UpdateParameters collection.

Suppression

Définir le DeleteMethod méthode ou fonction qui supprime les données de l’objet nom à la propriété de l’entreprise et inclure tous les paramètres nécessaires dans la DeleteParameters collection.

Insertion

Définir le InsertMethod méthode ou fonction qui insère des données de l’objet nom à la propriété de l’entreprise et inclure tous les paramètres nécessaires dans la InsertParameters collection.

Mise en cache

Définir le EnableCaching propriété trueet le CacheDuration et CacheExpirationPolicy propriétés selon le comportement de mise en cache que vous souhaitez pour vos données mises en cache.

System_CAPS_noteRemarque

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 convertis à partir du format de culture du client de la culture du serveur. Par exemple, la culture du client peut spécifier DD/MM/AAAA en tant que le format de date et le format de date sur le serveur peut être MM/jj/aaaa. Dans ce cas, le 5 octobre 2009 sera entré dans un TextBox contrôle en tant que 5/10/2009 mais sera 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.

Comme avec tous les contrôles de source de données, le ObjectDataSource contrôle est associé à une classe de vue de source de données. Alors que le ObjectDataSource contrôle est l’interface utilisée par le développeur de la page des données, la ObjectDataSourceView classe est l’interface des contrôles liés aux données. 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 possède une seule associés ObjectDataSourceView, et il est toujours nommé DefaultView. Alors que le ObjectDataSourceView objet est exposé par le 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, le ObjectDataSourceView objet effectue toutes les opérations de données, y compris la récupération, insertion, mise à jour, suppression, le filtrage et tri des données. Pour plus d'informations, consultez ObjectDataSourceView.

Vous pouvez utiliser la ObjectDataSource contrôle avec une classe LINQ to SQL. Pour ce faire, vous définissez le TypeName nom à la propriété de la classe de contexte de données. Vous définissez également la SelectMethod, UpdateMethod, InsertMethod, et DeleteMethod méthodes pour 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 le ObjectDisposing événements 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 LINQ aux classes SQL, consultez Comment : créer des Classes LINQ to SQL dans un projet Web. Pour obtenir un exemple montrant comment annuler la suppression d’une classe de contexte de données, consultez la ObjectDisposing événement.

Vous pouvez également utiliser le ObjectDataSource contrôle avec Entity Framework. Pour plus d’informations, consultez Using the Entity Framework and the ObjectDataSource Control.

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

Un projet de site Web Visual Studio avec code source est disponible pour accompagner cette rubrique : Download.

Cette section présente une ObjectDataSource dans le balisage dans un .aspx page qui montre qu’il fonctionne avec des objets métier. L’exemple est la page .aspx. Il contient un GridView contrôle qui est lié à un ObjectDataSource contrôle. Le ObjectDataSource 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>

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

  • Le EmployeeLogic classe est la classe de la logique métier qui le ObjectDataSource utilise.

  • Le NorthwindEmployee classe définit l’objet de données qui est retourné par la GetAllEmployees méthode de la EmployeeLogic classe.

Un autre NorthwindDataException classe est fournie pour des raisons pratiques.

Cet ensemble d’exemples de classes fonctionne avec la base de données Northwind Traders, qui est disponible avec Microsoft SQL Server et Microsoft Access. Pour obtenir un exemple complet, vous devez compiler et utiliser ces classes avec l’exemple de page .aspx qui est fourni. Pour plus d’informations sur l’installation de la base de données Northwind Traders, consultez Comment : installer des exemples de bases de données.

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

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: