共用方式為

AccessDataSourceDesigner.PreFilterProperties(IDictionary) 方法

  • 參考

定義

命名空間:
System.Web.UI.Design.WebControls
組件:
System.Design.dll

供設計工具使用，以便在 [屬性] 方格中加入或移除屬性，或是遮蔽關聯控制項的屬性。

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) 將屬性新增至設計階段屬性集合，或變更其屬性。 在執行其他處理之前，請務必先呼叫基底方法。

適用於

另請參閱