Freigeben über


HierarchicalDataBoundControlDesigner.PreFilterProperties(IDictionary) Methode

Definition

Wird vom Designer zum Entfernen von Eigenschaften aus der Anzeige im Eigenschaftenraster, zum Hinzufügen zusätzlicher Eigenschaften oder zum Durchführen von Shadowing von Eigenschaften des zugehörigen Steuerelements verwendet.

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)

Parameter

properties
IDictionary

Eine Auflistung, die das IDictionary von hinzugefügten Eigenschaften und Shadowing-Eigenschaften implementiert.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die Methode in einer Klasse außer Kraft setzen, die PreFilterProperties von der HierarchicalDataBoundControlDesigner Klasse geerbt wird, um das Eigenschaftenraster des HierarchicalDataBoundControl Steuerelements zur Entwurfszeit zu ändern. Im Beispiel wird die NamingContainer Eigenschaft im Eigenschaftenraster sichtbar.

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

Hinweise

Steuerelementdesigner verwenden Methoden, die von der ComponentDesigner.PreFilterProperties Methode abgeleitet werden, um verschiedene Steuerelementeigenschaften mit entsprechenden Entwurfszeiteigenschaften zu schatten, die der Designer implementiert, und um Eigenschaften zum Eigenschaftenraster hinzuzufügen oder zu entfernen.

Bei Steuerelementen, die aus der HierarchicalDataBoundControl Klasse abgeleitet werden, erstellt die PreFilterProperties Methode Entwurfszeiteigenschaften, um die DataSource und DataSourceID die Eigenschaften abzuschatten.

Hinweise für Vererber

Überschreiben Sie die PreFilterProperties(IDictionary) Methode, um eigenschaften in der Entwurfszeit-Eigenschaftssammlung hinzuzufügen oder die Attribute von Eigenschaften zu ändern. Achten Sie darauf, die Basismethode aufzurufen, bevor Sie andere Verarbeitungen ausführen.

Gilt für

Siehe auch