共用方式為


HierarchicalDataBoundControlDesigner.PreFilterProperties(IDictionary) 方法

定義

供設計工具使用,以便在 [屬性] 方格的顯示中移除屬性或新增屬性,或是遮蔽關聯控制項的屬性。

protected:
 override void PreFilterProperties(System::Collections::IDictionary ^ properties);
protected override void PreFilterProperties (System.Collections.IDictionary properties);
override this.PreFilterProperties : System.Collections.IDictionary -> unit
Protected Overrides Sub PreFilterProperties (properties As IDictionary)

參數

properties
IDictionary

集合,實作已加入和已遮蔽屬性的 IDictionary

範例

下列程式碼範例示範如何在設計階段覆寫 PreFilterProperties 繼承自 HierarchicalDataBoundControlDesigner 類別的 類別中的 方法,以變更控制項的 HierarchicalDataBoundControl Properties 方格。 此範例會在 NamingContainer [屬性 ] 方格中顯示內容。

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

備註

控制項設計工具會使用衍生自 ComponentDesigner.PreFilterProperties 方法的方法,利用設計工具實作的對應設計階段屬性來遮蔽各種控制項屬性,以及將屬性加入至 Properties 方格或從 [屬性 ] 方格中移除屬性。

對於衍生自 類別的 HierarchicalDataBoundControl 控制項, PreFilterProperties 方法會建立設計階段屬性來遮蔽 DataSourceDataSourceID 屬性。

給繼承者的注意事項

覆寫 方法, PreFilterProperties(IDictionary) 在設計階段屬性集合中加入或變更屬性的屬性。 在執行其他處理之前,請務必先呼叫基底方法。

適用於

另請參閱