HierarchicalDataBoundControlDesigner.PreFilterProperties メソッド

.NET Framework クラス ライブラリ リファレンス

HierarchicalDataBoundControlDesigner.PreFilterProperties メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

[プロパティ] グリッドの表示に対してプロパティの削除や追加を行ったり、または、関連するコントロールのプロパティをシャドウするために、デザイナによって使用されます。

名前空間: System.Web.UI.Design.WebControls
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Protected Overrides Sub
 PreFilterProperties ( _
    properties As IDictionary _
)

Visual Basic (使用法)

Dim properties As IDictionary

Me.PreFilterProperties(properties)

C#

protected override void PreFilterProperties
 (
    IDictionary properties
)

C++

protected:
virtual void PreFilterProperties (
    IDictionary^ properties
) override

J#

protected void PreFilterProperties (
    IDictionary properties
)

JScript

protected override function PreFilterProperties
 (
    properties : IDictionary
)

パラメータ

properties

追加されたプロパティおよびシャドウ プロパティの IDictionary を実装するコレクション。

解説

コントロール デザイナは、ComponentDesigner.PreFilterProperties メソッドから派生したメソッドを使用して、各種のコントロール プロパティを対応するデザイン時プロパティを実装してシャドウしたり、[プロパティ] グリッドのプロパティを追加または削除したりできます。

HierarchicalDataBoundControl クラスから派生したコントロールの場合、PreFilterProperties メソッドは、デザイン時のプロパティを作成し、DataSource プロパティと DataSourceID プロパティをシャドウします。

継承時の注意 デザイン時のプロパティ コレクションに対し、プロパティを追加したり、プロパティの属性を変更したりするには、PreFilterProperties メソッドをオーバーライドします。他の処理を実行する前に、必ず基本メソッドを呼び出してください。

使用例

HierarchicalDataBoundControlDesigner クラスから継承したクラスで PreFilterProperties メソッドをオーバーライドし、デザイン時に、HierarchicalDataBoundControl コントロールの [プロパティ] グリッドを変更する方法を次のコード例に示します。この例では、[プロパティ] グリッドから NamingContainer プロパティを参照できるようにしています。

Visual Basic

' Shadow the control properties with design-time properties.
Protected Overrides Sub
 PreFilterProperties( _
    ByVal properties As IDictionary)

    Dim namingContainer As String
 = "NamingContainer"

    ' Call the base method first.
    MyBase.PreFilterProperties(properties)

    ' Make the NamingContainery visible in the Properties grid.
    Dim selectProp As PropertyDescriptor =
 _
        CType(properties(namingContainer), PropertyDescriptor)
    properties(namingContainer) = _
        TypeDescriptor.CreateProperty(selectProp.ComponentType, _
            selectProp, BrowsableAttribute.Yes)
End Sub ' PreFilterProperties

C#

// Shadow the control properties with design-time properties.
protected override void PreFilterProperties(IDictionary
 properties)
{
    string namingContainer = "NamingContainer";

    // Call the base method first.
    base.PreFilterProperties(properties);

    // Make the NamingContainery visible in the Properties grid.
    PropertyDescriptor selectProp =
        (PropertyDescriptor)properties[namingContainer];
    properties[namingContainer] =
        TypeDescriptor.CreateProperty(selectProp.ComponentType,
            selectProp, BrowsableAttribute.Yes);
} // PreFilterProperties

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HierarchicalDataBoundControlDesigner クラス
HierarchicalDataBoundControlDesigner メンバ
System.Web.UI.Design.WebControls 名前空間
HierarchicalDataBoundControl
DataSource
DataSourceID
BaseDataBoundControlDesigner.PreFilterProperties
ControlDesigner.PreFilterProperties
HtmlControlDesigner.PreFilterProperties