ObjectDataSourceDesigner 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.
Fournit la prise en charge au moment du design dans un concepteur visuel pour le contrôle serveur web ObjectDataSource.
public ref class ObjectDataSourceDesigner : System::Web::UI::Design::DataSourceDesigner
public class ObjectDataSourceDesigner : System.Web.UI.Design.DataSourceDesigner
type ObjectDataSourceDesigner = class
inherit DataSourceDesigner
Public Class ObjectDataSourceDesigner
Inherits DataSourceDesigner
- Héritage
-
ObjectDataSourceDesigner
Exemples
L’exemple de code suivant montre comment étendre la ObjectDataSourceDesigner classe pour modifier l’apparence et le comportement des contrôles dérivés du contrôle au moment de la ObjectDataSource conception.
L’exemple dérive le MyObjectDataSource
contrôle de .ObjectDataSource est MyObjectDataSource
une copie du ObjectDataSource contrôle. L’exemple dérive également la MyObjectDataSourceDesigner
classe du ObjectDataSourceDesigner et applique un DesignerAttribute attribut pour le MyObjectDataSourceDesigner
sur le MyObjectDataSource
contrôle.
remplace MyObjectDataSourceDesigner
la PreFilterProperties méthode pour rendre la NamingContainer propriété visible dans la grille Propriétés au moment de la conception.
remplace MyObjectDataSourceDesigner
la GetDesignTimeHtml méthode pour afficher les TypeName propriétés et SelectMethod dans un espace réservé, en plus du type de contrôle et de l’ID.
using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The MyObjectDataSource is a copy of the ObjectDataSource.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.
MyObjectDataSourceDesigner))]
public class MyObjectDataSource : ObjectDataSource
{
} // MyObjectDataSource
// Derive a designer that inherits from the ObjectDataSourceDesigner.
[ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
public class MyObjectDataSourceDesigner : ObjectDataSourceDesigner
{
// Generate the design-time markup.
public override string GetDesignTimeHtml()
{
// Get a reference to the control or a copy of the control.
MyObjectDataSource myODS = (MyObjectDataSource)ViewControl;
// Create a placeholder that displays the type of the business
// object and the name of the Select method.
string markup = CreatePlaceHolderDesignTimeHtml(
"<b>TypeName</b> \"" + myODS.TypeName + "\"<br />" +
"<b>SelectMethod</b> \"" + myODS.SelectMethod + "\"" );
return markup;
} // GetDesignTimeHtml
// Shadow the control properties with design-time properties.
protected override void PreFilterProperties(IDictionary properties)
{
// Call the base method first.
base.PreFilterProperties(properties);
// Make the NamingContainer visible in the Properties grid.
PropertyDescriptor selectProp =
(PropertyDescriptor)properties["NamingContainer"];
properties["NamingContainer"] =
TypeDescriptor.CreateProperty(selectProp.ComponentType,
selectProp, BrowsableAttribute.Yes);
} // PreFilterProperties
} // MyObjectDataSourceDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The MyObjectDataSource is a copy of the ObjectDataSource.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(Examples.VB.WebControls.Design. _
MyObjectDataSourceDesigner))> _
Public Class MyObjectDataSource
Inherits ObjectDataSource
End Class
' Derive a designer that inherits from the ObjectDataSourceDesigner.
<ReflectionPermission(SecurityAction.Demand, Flags:=ReflectionPermissionFlag.MemberAccess)> _
Public Class MyObjectDataSourceDesigner
Inherits ObjectDataSourceDesigner
' Generate the design-time markup.
Public Overrides Function GetDesignTimeHtml() As String
' Get a reference to the control or a copy of the control.
Dim myODS As MyObjectDataSource = _
CType(ViewControl, MyObjectDataSource)
Dim markup As String = _
CreatePlaceHolderDesignTimeHtml( _
"<b>TypeName</b> """ & myODS.TypeName & """<br />" & _
"<b>SelectMethod</b> """ & myODS.SelectMethod & """")
Return markup
End Function ' GetDesignTimeHtml
' Shadow the control properties with design-time properties.
Protected Overrides Sub PreFilterProperties( _
ByVal properties As IDictionary)
' Call the base method first.
MyBase.PreFilterProperties(properties)
' Make the NamingContainer visible in the Properties grid.
Dim selectProp As PropertyDescriptor = _
CType(properties("NamingContainer"), PropertyDescriptor)
properties("NamingContainer") = _
TypeDescriptor.CreateProperty(selectProp.ComponentType, _
selectProp, BrowsableAttribute.Yes)
End Sub
End Class
End Namespace ' Examples.VB.WebControls.Design
Remarques
Le ObjectDataSource contrôle représente une source de données qui appelle des méthodes d’un objet métier afin d’effectuer les opérations Supprimer, Insérer, Sélectionner et Mettre à jour la base de données.
Dans un concepteur visuel, lorsque vous basculez du mode Source en mode Création, le code source de balisage qui décrit le ObjectDataSource contrôle est analysé et une version au moment du design du contrôle est créée sur l’aire de conception. Lorsque vous revenez à la vue Source, le contrôle au moment du design est conservé dans le code source de balisage et modifié dans le balisage de la page web. La ObjectDataSourceDesigner classe fournit une prise en charge au moment du design pour le ObjectDataSource contrôle dans un concepteur visuel.
Les ObjectDataSourceDesigner membres de la classe fournissent les fonctionnalités suivantes :
La CanConfigure propriété indique si l’Assistant Configurer la source de données peut être affiché. La CanRefreshSchema propriété indique si le schéma du contrôle associé ObjectDataSource peut être actualisé au moment de la conception.
La SelectMethod propriété spécifie la méthode qui exécute la fonction Select. La TypeName propriété spécifie le type de l’objet métier qui fournit les données du contrôle associé.
La GetView méthode retourne une vue de source de données avec le nom spécifié. La GetViewNames méthode retourne une liste de noms d’affichage de source de données pour le contrôle associé ObjectDataSource . La RefreshSchema méthode extrait les métadonnées de la méthode Select de l’objet métier associé.
La Configure méthode entraîne l’affichage de l’Assistant Configurer la source de données sur l’aire du concepteur visuel. La PreFilterProperties méthode supprime les propriétés du contrôle associé, ajoute des propriétés supplémentaires à, ou les ombres des propriétés du contrôle associé.
Constructeurs
ObjectDataSourceDesigner() |
Initialise une nouvelle instance de la classe ObjectDataSourceDesigner. |
Propriétés
ActionLists |
Obtient une liste des éléments utilisés pour créer un menu de liste d'actions au moment du design. (Hérité de DataSourceDesigner) |
AllowResize |
Obtient une valeur indiquant si le contrôle peut être redimensionné dans l'environnement au moment du design. (Hérité de ControlDesigner) |
AssociatedComponents |
Obtient la collection de composants associés au composant géré par le concepteur. (Hérité de ComponentDesigner) |
AutoFormats |
Obtient la collection de schémas de mise en forme automatique prédéfinis à afficher dans la boîte de dialogue Mise en forme automatique pour le contrôle associé au moment du design. (Hérité de ControlDesigner) |
Behavior |
Obsolète.
Obtient ou définit le comportement DHTML associé au concepteur. (Hérité de HtmlControlDesigner) |
CanConfigure |
Obtient une valeur qui indique si la méthode Configure() peut être appelée. |
CanRefreshSchema |
Obtient une valeur qui indique si la méthode RefreshSchema(Boolean) peut être appelée. |
Component |
Obtient le composant qui est créé par ce concepteur. (Hérité de ComponentDesigner) |
DataBindings |
Obtient la collection de liaisons de données pour le contrôle actuel. (Hérité de HtmlControlDesigner) |
DataBindingsEnabled |
Obtient une valeur indiquant si la liaison de données est prise en charge par la zone conteneur du contrôle associé (Hérité de ControlDesigner) |
DesignerState |
Obtient un objet qui est utilisé pour rendre persistantes les données du contrôle associé au moment du design. (Hérité de ControlDesigner) |
DesignTimeElement |
Obsolète.
Obtient l'objet de design représentant le contrôle associé à l'objet HtmlControlDesigner sur l'aire de conception. (Hérité de HtmlControlDesigner) |
DesignTimeElementView |
Obsolète.
Obtient l’objet de contrôle d’affichage du concepteur de contrôles. (Hérité de ControlDesigner) |
DesignTimeHtmlRequiresLoadComplete |
Obsolète.
Obtient une valeur qui indique si l'hôte de conception doit terminer le chargement avant que la méthode GetDesignTimeHtml ne puisse être appelée. (Hérité de ControlDesigner) |
Expressions |
Obtient les liaisons d'expressions pour le contrôle en cours au moment du design. (Hérité de HtmlControlDesigner) |
HidePropertiesInTemplateMode |
Obtient une valeur indiquant si les propriétés du contrôle associé sont masquées lorsque le contrôle est en mode modèles. (Hérité de ControlDesigner) |
ID |
Obtient ou définit la chaîne d'identification pour le contrôle. (Hérité de ControlDesigner) |
InheritanceAttribute |
Obtient un attribut qui indique le type d'héritage du composant associé. (Hérité de ComponentDesigner) |
Inherited |
Obtient une valeur indiquant si ce composant est hérité. (Hérité de ComponentDesigner) |
InTemplateMode |
Obtient une valeur qui indique si le contrôle se trouve en mode d'affichage ou de modification de modèle dans l'hôte de conception. La propriété InTemplateMode est en lecture seule. (Hérité de ControlDesigner) |
IsDirty |
Obsolète.
Obtient ou définit une valeur indiquant si le contrôle serveur Web a été signalé comme étant modifié. (Hérité de ControlDesigner) |
ParentComponent |
Obtient le composant parent de ce concepteur. (Hérité de ComponentDesigner) |
ReadOnly |
Obsolète.
Obtient ou définit une valeur qui indique si les propriétés du contrôle sont en lecture seule au moment du design. (Hérité de ControlDesigner) |
RootDesigner |
Obtient le Concepteur de contrôles de la page Web Forms qui contient le contrôle associé. (Hérité de ControlDesigner) |
SelectMethod |
Obtient ou définit le nom de la méthode à exécuter lorsque la méthode Select() du contrôle associé est appelée. |
SetTextualDefaultProperty |
Fournit la prise en charge au moment du design dans un concepteur visuel pour le contrôle serveur web ObjectDataSource. (Hérité de ComponentDesigner) |
ShadowProperties |
Obtient une collection de valeurs de propriétés qui substituent les paramètres utilisateur. (Hérité de ComponentDesigner) |
ShouldCodeSerialize |
Obsolète.
Obtient ou définit une valeur indiquant s'il faut créer une déclaration de champ pour le contrôle dans le fichier code-behind pour le document de design actuel pendant la sérialisation. (Hérité de HtmlControlDesigner) |
SuppressingDataSourceEvents |
Obtient une valeur qui indique si l'événement DataSourceChanged ou la méthode RefreshSchema(Boolean) se produit. (Hérité de DataSourceDesigner) |
Tag |
Obtient un objet représentant l'élément de balisage HTML pour le contrôle associé. (Hérité de ControlDesigner) |
TemplateGroups |
Obtient une collection de groupes de modèles, chacun contenant une ou plusieurs définitions de modèle. (Hérité de ControlDesigner) |
TypeName |
Obtient ou définit le nom du type qui contient les méthodes qui sont spécifiées dans le contrôle associé. |
UsePreviewControl |
Obtient une valeur indiquant si le concepteur de contrôles utilise un contrôle d’aperçu temporaire pour générer le balisage HTML au moment du design. (Hérité de ControlDesigner) |
Verbs |
Obtient les verbes de design pris en charge par le composant associé au concepteur. (Hérité de ComponentDesigner) |
ViewControl |
Obtient ou définit un contrôle serveur Web qui peut être utilisé pour afficher un aperçu du balisage HTML au moment du design. (Hérité de ControlDesigner) |
ViewControlCreated |
Obtient ou définit une valeur qui indique si un contrôle |
Visible |
Obtient une valeur qui indique si le contrôle est visible au moment de la conception. (Hérité de ControlDesigner) |
Méthodes
Configure() |
Affiche l'Assistant Configurer la source de données dans l'aire du concepteur visuel. |
CreateErrorDesignTimeHtml(String) |
Crée le balisage HTML pour afficher un message d'erreur spécifié au moment du design. (Hérité de ControlDesigner) |
CreateErrorDesignTimeHtml(String, Exception) |
Crée le balisage HTML pour afficher un message d'erreur d'exception spécifié au moment du design. (Hérité de ControlDesigner) |
CreatePlaceHolderDesignTimeHtml() |
Fournit une représentation d'espace réservé rectangulaire simple qui affiche le type et l'ID du contrôle. (Hérité de ControlDesigner) |
CreatePlaceHolderDesignTimeHtml(String) |
Fournit une représentation d'espace réservé rectangulaire simple qui affiche le type et l'ID du contrôle, ainsi que d'autres instructions ou informations spécifiées. (Hérité de ControlDesigner) |
CreateViewControl() |
Retourne une copie du contrôle associé pour l'affichage ou le rendu sur l'aire de conception. (Hérité de ControlDesigner) |
Dispose() |
Libère toutes les ressources utilisées par ComponentDesigner. (Hérité de ComponentDesigner) |
Dispose(Boolean) |
Libère les ressources non managées utilisées par l'objet HtmlControlDesigner et libère éventuellement les ressources managées. (Hérité de HtmlControlDesigner) |
DoDefaultAction() |
Crée une signature de méthode dans le fichier de code source de l'événement par défaut du composant et déplace le curseur de l'utilisateur jusqu'à cet emplacement. (Hérité de ComponentDesigner) |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetBounds() |
Récupère les coordonnées du rectangle représentant les limites du contrôle affiché sur l'aire de conception. (Hérité de ControlDesigner) |
GetDesignTimeHtml() |
Récupère le balisage HTML pour afficher le contrôle de source de données associé au moment du design. (Hérité de DataSourceDesigner) |
GetDesignTimeHtml(DesignerRegionCollection) |
Récupère le balisage HTML pour afficher le contrôle et remplit la collection avec les zones du Concepteur de contrôles actuelles. (Hérité de ControlDesigner) |
GetEditableDesignerRegionContent(EditableDesignerRegion) |
Retourne le contenu d'une région modifiable de la vue au moment de la conception du contrôle associé. (Hérité de ControlDesigner) |
GetEmptyDesignTimeHtml() |
Récupère le balisage HTML pour représenter un contrôle serveur web au moment du design qui n’aura aucune représentation visuelle au moment de l’exécution. (Hérité de ControlDesigner) |
GetErrorDesignTimeHtml(Exception) |
Récupère le balisage HTML qui fournit des informations sur l’exception spécifiée. (Hérité de ControlDesigner) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetPersistenceContent() |
Récupère le balisage HTML interne persistable du contrôle au moment du design. (Hérité de ControlDesigner) |
GetPersistInnerHtml() |
Obsolète.
Récupère le balisage HTML interne persistable du contrôle. (Hérité de ControlDesigner) |
GetService(Type) |
Tente de récupérer le type spécifié de service du composant du concepteur du site en mode Design. (Hérité de ComponentDesigner) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
GetView(String) |
Retourne une vue de source de données avec le nom spécifié. |
GetViewNames() |
Retourne une liste de noms de vues de sources de données pour le contrôle associé. |
GetViewRendering() |
Récupère un objet qui contient le balisage au moment du design pour le contenu et les zones du contrôle associé. (Hérité de ControlDesigner) |
Initialize(IComponent) |
Initialise le Concepteur de contrôles et charge le composant spécifié. (Hérité de ControlDesigner) |
InitializeExistingComponent(IDictionary) |
Réinitialise un composant existant. (Hérité de ComponentDesigner) |
InitializeNewComponent(IDictionary) |
Initialise un composant nouvellement créé. (Hérité de ComponentDesigner) |
InitializeNonDefault() |
Obsolète.
Obsolète.
Initialise les paramètres d'un composant importé qui est déjà initialisé pour utiliser des paramètres autres que ceux par défaut. (Hérité de ComponentDesigner) |
Invalidate() |
Invalide la zone complète du contrôle affiché sur l'aire de conception et signale au Concepteur de contrôles qu'il doit redessiner le contrôle. (Hérité de ControlDesigner) |
Invalidate(Rectangle) |
Invalide la zone spécifiée du contrôle affiché sur l'aire de conception et signale au Concepteur de contrôles qu'il doit redessiner le contrôle. (Hérité de ControlDesigner) |
InvokeGetInheritanceAttribute(ComponentDesigner) |
Obtient le InheritanceAttribute du ComponentDesigner spécifié. (Hérité de ComponentDesigner) |
IsPropertyBound(String) |
Obsolète.
Récupère une valeur indiquant si la propriété spécifiée sur le contrôle associé est liée aux données. (Hérité de ControlDesigner) |
Localize(IDesignTimeResourceWriter) |
Utilise le writer de ressource fourni pour rendre persistantes les propriétés localisables du contrôle associé dans une ressource de l'hôte de conception. (Hérité de ControlDesigner) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
OnAutoFormatApplied(DesignerAutoFormat) |
Appelée lorsqu'un schéma de mise en forme automatique prédéfini a été appliqué au contrôle associé. (Hérité de ControlDesigner) |
OnBehaviorAttached() |
Appelé quand le Concepteur de contrôles est attaché à un objet Behavior. (Hérité de ControlDesigner) |
OnBehaviorDetaching() |
Obsolète.
Appelé lorsqu'un comportement se dissocie de l'élément. (Hérité de HtmlControlDesigner) |
OnBindingsCollectionChanged(String) |
Obsolète.
Appelée lorsque la collection de liaisons de données change. (Hérité de ControlDesigner) |
OnClick(DesignerRegionMouseEventArgs) |
Appelé par l'hôte de conception lorsque l'utilisateur clique sur le contrôle associé au moment du design. (Hérité de ControlDesigner) |
OnComponentChanged(Object, ComponentChangedEventArgs) |
Appelé lorsque le contrôle associé change. (Hérité de ControlDesigner) |
OnComponentChanging(Object, ComponentChangingEventArgs) |
Représente la méthode qui gérera l'événement ComponentChanging pour le contrôle associé. (Hérité de ControlDesigner) |
OnControlResize() |
Obsolète.
Appelé lorsque le contrôle serveur Web associé a été redimensionné dans l'hôte de conception au moment du design. (Hérité de ControlDesigner) |
OnDataSourceChanged(EventArgs) |
Déclenche l'événement DataSourceChanged lorsque les propriétés de la source de données ont changé et que la valeur SuppressingDataSourceEvents est |
OnPaint(PaintEventArgs) |
Appelé lorsque le Concepteur de contrôles dessine le contrôle associé sur l'aire de conception, si la valeur CustomPaint est |
OnSchemaRefreshed(EventArgs) |
Déclenche l'événement SchemaRefreshed lorsque le schéma de la source de données a changé et que la valeur SuppressingDataSourceEvents est |
OnSetComponentDefaults() |
Obsolète.
Obsolète.
Définit les propriétés par défaut du composant. (Hérité de ComponentDesigner) |
OnSetParent() |
Offre un moyen d'effectuer un traitement supplémentaire lorsque le contrôle associé est attaché à un contrôle parent. (Hérité de HtmlControlDesigner) |
PostFilterAttributes(IDictionary) |
Permet à un concepteur de modifier ou de supprimer des éléments de l'ensemble d'attributs qu'il expose à l'aide d'un TypeDescriptor. (Hérité de ComponentDesigner) |
PostFilterEvents(IDictionary) |
Permet à un concepteur de modifier ou de supprimer des éléments de l'ensemble d'événements à l'aide d'un TypeDescriptor. (Hérité de ComponentDesigner) |
PostFilterProperties(IDictionary) |
Permet à un concepteur de modifier ou de supprimer des éléments de l'ensemble de propriétés qu'il expose à l'aide d'un TypeDescriptor. (Hérité de ComponentDesigner) |
PreFilterAttributes(IDictionary) |
Permet à un concepteur d'ajouter des éléments à l'ensemble d'attributs qu'il expose à l'aide d'un TypeDescriptor. (Hérité de ComponentDesigner) |
PreFilterEvents(IDictionary) |
Définit la liste des événements qui sont exposés au moment du design pour l'objet TypeDescriptor du composant. (Hérité de HtmlControlDesigner) |
PreFilterProperties(IDictionary) |
Utilisé par le concepteur pour supprimer ou ajouter des propriétés s’affichant dans la grille Properties ou pour occulter les propriétés du contrôle associé. |
RaiseComponentChanged(MemberDescriptor, Object, Object) |
Avertit le IComponentChangeService que ce composant a été modifié. (Hérité de ComponentDesigner) |
RaiseComponentChanging(MemberDescriptor) |
Avertit le IComponentChangeService que ce composant est sur le point d'être modifié. (Hérité de ComponentDesigner) |
RaiseResizeEvent() |
Obsolète.
Déclenche l’événement OnControlResize(). (Hérité de ControlDesigner) |
RefreshSchema(Boolean) |
Extrait les métadonnées pour la méthode Select à partir de l'objet métier qui est spécifié par le contrôle associé. |
RegisterClone(Object, Object) |
Inscrit des données internes dans un contrôle cloné. (Hérité de ControlDesigner) |
ResumeDataSourceEvents() |
Restaure les événements de source de données après que ceux-ci ont été supprimés. (Hérité de DataSourceDesigner) |
SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Spécifie le contenu pour une zone modifiable du contrôle au moment du design. (Hérité de ControlDesigner) |
SetRegionContent(EditableDesignerRegion, String) |
Spécifie le contenu d'une zone modifiable de la vue design du contrôle. (Hérité de ControlDesigner) |
SetViewFlags(ViewFlags, Boolean) |
Assigne l'énumération ViewFlags de bits spécifiée à la valeur d'indicateur spécifiée. (Hérité de ControlDesigner) |
SuppressDataSourceEvents() |
Diffère tous les événements de source de données jusqu'à l'appel de la méthode ResumeDataSourceEvents(). (Hérité de DataSourceDesigner) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
UpdateDesignTimeHtml() |
Actualise le balisage HTML au moment du design du contrôle serveur Web associé en appelant la méthode GetDesignTimeHtml. (Hérité de ControlDesigner) |
Événements
DataSourceChanged |
Se produit lorsqu'une propriété quelconque de la source de données associée est modifiée. (Hérité de DataSourceDesigner) |
SchemaRefreshed |
Se produit après l'actualisation du schéma. (Hérité de DataSourceDesigner) |