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 示しています。

この例では、 からコントロールをMyObjectDataSourceObjectDataSource派生させます。 MyObjectDataSourceはコントロールのObjectDataSourceコピーです。 この例では、 から クラスをMyObjectDataSourceDesigner派生させ、 コントロールに のMyObjectDataSourceDesigner属性をMyObjectDataSource適用DesignerAttributeします。ObjectDataSourceDesigner

は MyObjectDataSourceDesigner 、 メソッドを PreFilterProperties オーバーライドして、プロパティを NamingContainer デザイン時に [プロパティ ] グリッドに表示します。

は MyObjectDataSourceDesigner 、 メソッドを GetDesignTimeHtml オーバーライドして、コントロールの TypeName 種類と SelectMethod 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

注釈

コントロールは ObjectDataSource 、データベースの削除、挿入、選択、および更新の各操作を実行するために、ビジネス オブジェクトのメソッドを呼び出すデータ ソースを表します。

ビジュアル デザイナーで、[ソース] ビューから [デザイン] ビューに切り替えると、コントロールを記述 ObjectDataSource するマークアップ ソース コードが解析され、デザイン サーフェイスにコントロールのデザイン時バージョンが作成されます。 ソース ビューに戻ると、デザイン時コントロールはマークアップ ソース コードに永続化され、Web ページのマークアップに編集されます。 クラスは 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 サーバー コントロール用の基本的なコントロール デザイナーの作成