AccessDataSourceDesigner.PreFilterProperties(IDictionary) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
供設計工具使用,以便在 [屬性] 方格中加入或移除屬性,或是遮蔽關聯控制項的屬性。
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使ConnectionString屬性在 [屬性] 方格中變成只讀且可見。
此程式代碼範例是針對 類別提供的較大範例的 AccessDataSourceDesigner 一部分。
// Shadow control properties with design time properties.
protected override void PreFilterProperties(IDictionary properties)
{
// Call the base class method first.
base.PreFilterProperties(properties);
// Add the ConnectionString property to the property grid.
PropertyDescriptor property =
(PropertyDescriptor)properties["ConnectionString"];
Attribute[] attributes = new Attribute[]
{
new BrowsableAttribute(true),
new ReadOnlyAttribute(true)
};
properties["ConnectionString"] = TypeDescriptor.CreateProperty(
GetType(), property, attributes);
}
' Shadow control properties with design time properties.
Protected Overrides Sub PreFilterProperties(ByVal properties As IDictionary)
' Call the base class method first.
MyBase.PreFilterProperties(properties)
' Add the ConnectionString property to the property grid.
Dim prop As PropertyDescriptor
prop = CType(properties("ConnectionString"), PropertyDescriptor)
Dim atts(1) As Attribute
atts(0) = New BrowsableAttribute(True)
atts(1) = New ReadOnlyAttribute(True)
properties("ConnectionString") = TypeDescriptor.CreateProperty( _
prop.GetType(), prop, atts)
End Sub
備註
控件設計工具會使用衍生自 ComponentDesigner.PreFilterProperties 方法的方法,使用設計工具實作的對應設計時間屬性來陰影各種控件屬性,以及新增屬性,或從 [屬性 ] 方格中移除屬性。
AccessDataSource針對控件,PreFilterProperties方法會建立設計時間DataFile屬性,以陰影控件DataFile的屬性。
給繼承者的注意事項
PreFilterProperties(IDictionary)覆寫 方法,將屬性新增至設計時間屬性集合或變更其屬性。 在執行其他處理之前,請務必先呼叫基底方法。