ObjectDataSourceDesigner 类

定义

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

继承

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

DataSourceDesigner

ObjectDataSourceDesigner

示例

下面的代码示例演示如何扩展 ObjectDataSourceDesigner 类，以在设计时更改派生自 ObjectDataSource 控件的控件的外观和行为。

该示例从 ObjectDataSource派生MyObjectDataSource控件。 MyObjectDataSource是 控件的副本ObjectDataSource。 该示例还从 派生MyObjectDataSourceDesigner类，ObjectDataSourceDesigner并为 控件上的 MyObjectDataSource 应用 DesignerAttribute 属性MyObjectDataSourceDesigner。

重写 MyObjectDataSourceDesigner 方法， PreFilterProperties 使 NamingContainer 属性在设计时在 “属性” 网格中可见。

GetDesignTimeHtml除了控件类型和 ID 之外， 重写 MyObjectDataSourceDesigner 方法以在占位符中显示 TypeName 和 SelectMethod 属性。

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

注解

控件 ObjectDataSource 表示一个数据源，该数据源调用业务对象的方法以执行删除、插入、选择和更新数据库操作。

在可视化设计器中，从“源”视图切换到“设计”视图时，将分析描述控件的 ObjectDataSource 标记源代码，并在设计图面上创建控件的设计时版本。 切换回源视图时，设计时控件将保留到标记源代码中，并编辑到网页的标记中。 类 ObjectDataSourceDesigner 为可视化设计器中的 控件提供设计时支持 ObjectDataSource 。

类 ObjectDataSourceDesigner 成员提供以下功能：

• 属性 CanConfigure 指示是否可以显示“配置数据源”向导。 属性 CanRefreshSchema 指示是否可以在设计时刷新关联 ObjectDataSource 控件的架构。

• 属性 SelectMethod 指定执行 Select 函数的方法。 属性 TypeName 指定为关联控件提供数据的业务对象的类型。

• 方法 GetView 返回具有指定名称的数据源视图。 方法 GetViewNames 返回关联 ObjectDataSource 控件的数据源视图名称列表。 方法 RefreshSchema 从关联的业务对象中提取 Select 方法的元数据。

• 方法 Configure 会导致“配置数据源”向导显示在可视化设计器图面上。 方法 PreFilterProperties 从 中删除属性、向关联控件添加其他属性或隐藏关联控件的属性。

构造函数

属性

方法

事件

显式接口实现

适用于

另请参阅

• ObjectDataSource
• DataSourceControl
• DataSourceDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• ASP.NET 控件设计器简介
• 演练：为 Web 服务器控件创建基本控件设计器