屬性 | 範例 |
|---|
BindableAttribute 設計階段屬性 指定這個屬性 (Attribute) 是否對於將資料繫結至屬性 (Property) 有意義。在視覺化設計工具中，屬性瀏覽器可以在對話方塊中顯示控制項的可繫結屬性 (例如，在 Visual Studio 中，可繫結屬性會顯示在 [DataBindings] 對話方塊中)。當屬性 (Property) 沒有以這個屬性 (Attribute) 特別標記時，屬性瀏覽器會將值推斷為 Bindable(false)。 | [Bindable(true)] 適用於逐步解說：開發和使用自訂的伺服器控制項中 WelcomeLabel 範例控制項的 Text 屬性。 |
BrowsableAttribute 設計階段屬性 指定屬性是否應該顯示在視覺化設計工具的屬性瀏覽器中。將 Browsable(false) 套用至您不希望在屬性瀏覽器中顯示的屬性。當屬性 (Property) 不是以這個屬性 (Attribute) 標記時，會由屬性瀏覽器推斷為預設值 Browsable(true)。 | [Browsable(false)] 適用於樣板化伺服器控制項範例中 VacationHome 範例控制項的 Template 屬性。 |
CategoryAttribute 設計階段屬性 指定如何在視覺化設計工具的屬性瀏覽器中對屬性進行分類。例如，當網頁開發人員使用屬性瀏覽器的分類檢視時，Category("Appearance") 會通知屬性瀏覽器在 [外觀] 分類中顯示屬性。您可以指定與屬性瀏覽器的現有分類相對應的字串引數，或建立自己的分類。 | [Category("Appearance")] 適用於逐步解說：開發和使用自訂的伺服器控制項中 WelcomeLabel 範例控制項的 Text 屬性。 |
DefaultValueAttribute 設計階段屬性 指定屬性的預設值。這個值應該與您從屬性存取子 (getter) 傳回的預設值相同。在某些視覺化設計工具中 (例如 Visual Studio)，DefaultValueAttribute 屬性可讓網頁開發人員使用快速鍵功能表上的 [重設] 命令，將屬性值重設為預設值。 | [DefaultValue("")] 適用於逐步解說：開發和使用自訂的伺服器控制項中 WelcomeLabel 範例控制項的 Text 屬性。 |
DescriptionAttribute 設計階段屬性 指定屬性的概要說明。在 Visual Studio 這類視覺化設計工具中，屬性瀏覽器通常會在視窗的底部，顯示所選取屬性的說明。 | [Description("The welcome message text.")] 適用於逐步解說：開發和使用自訂的伺服器控制項中 WelcomeLabel 範例控制項的 Text 屬性。 |
DesignerSerializationVisibilityAttribute 設計階段屬性 指定是否要序列化在設計階段時所設定的屬性，或其內容 (例如子屬性或集合項目)。屬性 (Attribute) 之建構函式的引數是 DesignerSerializationVisibility 列舉型別的值。未套用這個屬性 (Attribute) 且已序列化屬性 (Property) 值時，將使用預設值 Visible。 | [DesignerSerializationVisibility (DesignerSerializationVisibility.Content)] 適用於伺服器控制項屬性範例中 Book 範例控制項的 Author 屬性。 |
EditorAttribute 設計階段屬性 使自訂 UITypeEditor 編輯器與屬性 (Property) 或屬性型別產生關聯。如果這個屬性 (Attribute) 已套用至型別，則不需要套用至該型別的屬性 (Property)。 | [Editor(typeof(ContactCollectionEditor), typeof(UITypeEditor))] 適用於 Web 控制項集合屬性範例中 QuickContacts 範例控制項的 Contacts 屬性。 |
EditorBrowsableAttribute 設計階段屬性 指定屬性 (Property) 名稱是否出現在原始碼編輯器的 IntelliSense 清單中。這個屬性也可以套用至方法和事件。屬性 (Attribute) 之建構函式的引數是 EditorBrowsableState 列舉型別的值。未套用這個屬性時，會使用預設值 Always。 | [EditorBrowsableAttribute (EditorBrowsableState.Never)] 套用前一個範例中顯示的屬性，以便在 IntelliSense 中隱藏成員。 |
FilterableAttribute 設計階段和剖析階段屬性 指定屬性是否可以參與裝置和瀏覽器篩選。篩選可讓網頁開發人員在單一控制項宣告中，對不同的瀏覽器指定不同的屬性值。例如，網頁開發人員可以使用篩選對 Label 控制項的 Text 屬性設定不同的值，如下列語法所示：
<asp:Label UP:Text="Hello" and IE:Text="Welcome to my site" runat="server" />
"UP" 和 "IE" 是瀏覽器篩選條件。未套用這個屬性時，會使用預設值 Filterable(true)。 | [Filterable(false)] 套用前一個範例中顯示的屬性 (Attribute)，以便從裝置和瀏覽器篩選中排除屬性 (Property)。 |
LocalizableAttribute 設計階段屬性 指定這個屬性 (Attribute) 對當地語系化屬性 (Property) 是否有意義。屬性 (Property) 標記為 Localizable(true) 時，會在資源檔中儲存屬性值。未套用這個屬性時，會使用預設值 Localizable(false)。 | [Localizable(true)] 適用於逐步解說：開發和使用自訂的伺服器控制項中 WelcomeLabel 範例控制項的 Text 屬性。 |
NotifyParentPropertyAttribute 設計階段屬性 指定在屬性瀏覽器中，對子屬性所做的變更是否應該傳送至父屬性。 | [NotifyParentProperty(true)] 適用於伺服器控制項屬性範例中定義之 Author 型別的 FirstName、LastName 和 MiddleName 屬性。 |
PersistenceModeAttribute 設計階段屬性 指定是否將屬性 (Property) 保存為控制項標籤上的屬性 (Attribute)，或保存為控制項標籤中的巢狀內容。屬性 (Attribute) 之建構函式的引數是 PersistenceMode 列舉型別的值。 | [PersistenceMode(PersistenceMode.InnerProperty)] 適用於伺服器控制項屬性範例中 Book 範例控制項的 Author 屬性。 |
TemplateContainerAttribute 設計階段和剖析階段屬性 指定屬性的命名容器型別，它會傳回 ITemplate 介面。 | [TemplateContainer(typeof(CustomTemplateContainer))] 套用前述範例中所示的屬性，以指定由 CustomTemplateContainer 類別表示的 ITemplate 屬性。 |
TemplateInstanceAttribute 設計階段和剖析階段屬性 指定樣板屬性是否允許建立單一或多重執行個體。如果樣板屬性並未使用 TemplateInstanceAttribute 屬性擴充，則預設會建立多重執行個體。 | [TemplateInstance(TemplateInstance.Single)] 套用前述範例中所示的屬性，以指定只能建立樣板屬性的一個執行個體。 |
ThemeableAttribute 剖析階段屬性 指定控制項成員是否可受主題或控制面板影響。依照預設，如果控制項型別本身可以套用主題的話，則由控制項公開的所有屬性都可以套用主題。 | [Themeable(false)] 套用前述範例中所示的屬性，以預防控制項成員受主題或控制面板所影響。 |
TypeConverterAttribute 設計階段、剖析階段和執行階段屬性 使型別轉換子 (Type Converter) 與屬性或屬性型別產生關聯。型別轉換子會執行從字串表示到指定型別的轉換，反之亦然。 | [TypeConverter(typeof(AuthorConverter))] 適用於伺服器控制項屬性範例中定義的 Author 型別。 |
UrlPropertyAttribute 設計階段和執行階段屬性 指定字串屬性表示 URL 值，可讓您使 URL 產生器和屬性產生關聯。 | [UrlProperty("*.aspx",AllowedTypes=UrlTypes.Absolute|UrlTypes.RootRelative|UrlTypes.AppRelative)] 套用以設定 ASP.NET 檔案的特定檔案篩選條件，並可允許絕對和相對路徑。 |