C# 特性(Attribute)(二)

AttributeUsage類是另外一個預定義特性類，它幫助我們控制我們自己的定制特性的使用。它描述了一個定制特性如和被使用。  

  AttributeUsage有三個屬性，我們可以把它放置在定制屬性前面。第一個屬性是：  

  ValidOn  

  通過這個屬性，我們能夠定義定制特性應該在何種程式實體前放置。一個屬性可以被放置的所有程式實體在AttributeTargets enumerator中列出。通過OR操作我們可以把若幹個AttributeTargets值組合起來。  

  AllowMultiple  

  這個屬性标記了我們的定制特性能否被重複放置在同一個程式實體前多次。 

  Inherited  

  我們可以使用這個屬性來控制定制特性的繼承規則。它标記了我們的特性能否被繼承。  

  下面讓我們來做一些實際的東西。我們将會在剛才的Help特性前放置AttributeUsage特性以期待在它的幫助下控制Help特性的使用。  

  using System;

  [AttributeUsage(AttributeTargets.Class), AllowMultiple = false,

   Inherited = false ]

  public class HelpAttribute : Attribute

  {

   public HelpAttribute(String Description_in)

   {

   this.description = Description_in;

   }

   protected String description;

   public String Description

   get

   return this.description;

  }

  先讓我們來看一下AttributeTargets.Class。它規定了Help特性隻能被放在class的前面。這也就意味着下面的代碼将會産生錯誤：

  [Help("this is a do-nothing class")]

  public class AnyClass

   [Help("this is a do-nothing method")] //error

   public void AnyMethod()

  編譯器報告錯誤如下：  

  AnyClass.cs: Attribute 'Help' is not valid on this declaration type.  

  It is valid on 'class' declarations only.  

  我們可以使用AttributeTargets.All來允許Help特性被放置在任何程式實體前。可能的值是：  

  Assembly,

  Module,

  Class,

  Struct,

  Enum,

  Constructor,

  Method,

  Property,

  Field,

  Event,

  Interface,

  Parameter,

  Delegate,

  All = Assembly | Module | Class | Struct | Enum | Constructor | Method | Property | Field | Event | Interface | Parameter | Delegate,

  ClassMembers = Class | Struct | Enum | Constructor | Method | Property | Field | Event | Delegate | Interface )

  下面考慮一下AllowMultiple = false。它規定了特性不能被重複放置多次。  

  [Help("it contains a do-nothing method")]

  它産生了一個編譯期錯誤。  

  AnyClass.cs: Duplicate 'Help' attribute  

  Ok,現在我們來讨論一下最後的這個屬性。Inherited, 表明當特性被放置在一個基類上時，它能否被派生類所繼承。  

  [Help("BaseClass")]

  public class Base

  }  

  public class Derive : Base

  這裡會有四種可能的組合：  

  [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = false ]

  [AttributeUsage(AttributeTargets.Class, AllowMultiple = true, Inherited = false ]

  [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = true ]

  [AttributeUsage(AttributeTargets.Class, AllowMultiple = true, Inherited = true ]

  第一種情況：  

  如果我們查詢（Query）（稍後我們會看到如何在運作期查詢一個類的特性）Derive類，我們将會發現Help特性并不存在，因為inherited屬性被設定為false。  

  第二種情況：  

  和第一種情況相同，因為inherited也被設定為false。 

  第三種情況：  

  為了解釋第三種和第四種情況，我們先來給派生類添加點代碼：  

  [Help("DeriveClass")]

  現在我們來查詢一下Help特性，我們隻能得到派生類的屬性，因為inherited被設定為true，但是AllowMultiple卻被設定為false。是以基類的Help特性被派生類Help特性覆寫了。  

  第四種情況：  

  在這裡，我們将會發現派生類既有基類的Help特性，也有自己的Help特性，因為AllowMultiple被設定為true。

本文轉自莫水千流部落格園部落格，原文連結：http://www.cnblogs.com/zhoug2020/p/6721215.html，如需轉載請自行聯系原作者