DESC
    Class, Method に追加情報を与えるもの. 
    自分で新たな属性を作る場合は Attribute というクラスを継承して作成します。


  POINT
    NUnit は次のように解釈する。

    // [TestFixture]属性であるMyTestはテストクラスである
    [TestFixture]
    public class MyTest {

      // [Setup]属性であるInit()は各テストメソッドの開始前に呼ぶメソッドである
      [SetUp]
      public void Init() {
        // 各テストメソッドが呼ばれる前に行う処理
      }

      // [Test]属性をもつメソッドはテストメソッドである
      [Test]
      public void Test1() {
        // テスト処理
      }

      // [Test]属性をもつメソッドはテストメソッドである
      [Test]
      public void Test2() {
        // テスト処理
      }
    }




    namespace SampleCustomAttribute {

        // 自作したクラス用の属性 MyClassAttribute
        // -> なるほど ! 属性というクラスをつくるのか ^ ^/
        [AttributeUsage(AttributeTargets.Class)]
        class MyClassAttribute : Attribute {
           
            private string name;   // 名前 
            private bool isBool;   //  

            public MyClassAttribute(string name) {
                this.name = name;
            }

            // Accessor
            public string Name {
                get { return name; }
            }
            public bool IsBool {
                get { return isBool; }
                set { isBool = value; }
            }
        }
    }


    namespace SampleCustomAttribute {

        // 自作したメソッド用の属性 MyMethodAttribute

        //     [ AttributeUsage(...) ]は属性クラスの頭に必ずつける。
        [AttributeUsage(AttributeTargets.Method)]
        class MyMethodAttribute : Attribute {
            private string name;
            public MyMethodAttribute(string name) {
                this.name = name;
            }
            public string Name {
                get { return name; }
            }
        }
    }


    (...) の中は、

    クラスの属性の場合、AttributeTargets.Class
    メソッドの属性の場合、AttributeTargets.Method

    となります。

    では、これらの属性を使ってみます。
    namespace SampleCustomAttribute {
        [MyClass("this is HogeClass")]
        class HogeClass {
            [MyMethod("this is Method1.")]
            public void Method1() {
                Console.WriteLine("MyClass Method1().");
            }
        }
    }

    HogeClass というクラスに属性 MyClassAttribute を、
    Method1 に属性 MyMethodAttribute を付けました。

    属性を付けるときは、

    [MyClass("this is HogeClass")]    のように Attribute を省略も
    [MyClassAttribute("this is HogeClass")]    のようにAttributeを付けることもできる。

    Attribute は省くのが一般的。

    MyClassAttribute, MyMethodAttribute はコンストラクタで引数を取るので、
    属性を付ける際に引数を渡しています。

    もし MyClassAttribute のコンストラクタの引数がゼロだった場合、
    [MyClassAttribute]となる。

    また MyClassAttribute のプロパティ IsBool は以下のように設定できる。

    namespace SampleCustomAttribute {

       // class に属性をつけた. 
       [MyClass("this is HogeClass", IsBool=true)]
        class HogeClass {

            // Method に属性をつける。
            [MyMethod("this is Method1.")]
            public void Method1() {
                Console.WriteLine("MyClass Method1().");
            }
        }

    }

    IsBoolのようにsetを持つプロパティは、属性指定時に
    プロパティ名 = 値
    という風に書くことができます。
    コンストラクタの引数 - 必須の引数
    setをもつプロパティ - 必須でない引数
    という風に使い分けると良いでしょう。


___
■ 属性を読みだしてみる



   属性を付けても、その属性を読み出せなければ意味がない。
   主に リフレクション の機能を使う。

   namespace SampleCustomAttribute {

       class AttributeSearch {

           // クラスのタイプから指定されている MyClassAttribute 属性を取り出す
           // class の種類を指定するらしい. 
           public static MyClassAttribute[] GetMyClassAttribute( Type classType ) {

               object[] ary = classType.GetCustomAttributes( typeof(MyClassAttribute), false );
               // cast して返す.
               return ( MyClassAttribute[] )ary;
           }

           // クラス名から指定されている MyClassAttribute 属性を取り出す
           public static MyClassAttribute[] GetMyClassAttribute(string className) {

               // 名前から, ClassType を取得する. 
               // Type とは class の種類のことらしい. 
               Type classType = Type.GetType( className );
               
               // ↑のクラスに統合される. 
               return GetMyClassAttribute( classType );
           }

           // クラスのタイプとメソッド名から指定されている MyMethodAttribute 属性を取り出す
           public static MyMethodAttribute[] GetMyMethodAttribute(Type classType, string methodName) {
               MethodInfo info = classType.GetMethod(methodName);
               object [] ary = info.GetCustomAttributes(typeof(MyMethodAttribute), false);
               return (MyMethodAttribute[])ary;
           }

       }
   }

   1 つのクラス、メソッドに対して同じ属性を複数指定できるので
   戻り値は属性の配列となる。
   これらを使って MyClassから属性を取り出すことができる。

   // Type は ↑で定義した CustomAttributeClass 
   MyClassAttribute[] myClassAttributes;

   // static Method を利用して取得する. 
   myClassAttributes = AttributeSearch.GetMyClassAttribute( typeof(HogeClass) );
   myClassAttributes = AttributeSearch.GetMyClassAttribute( "SampleCustomAttribute.MyClass" );

   // Method を得る. 
   MyMethodAttribute[] myMethodAttributes;
   myMethodAttributes = AttributeSearch.GetMyMethodAttribute(typeof(HogeClass), "Method1");