属性とメタデータ(Attribute)

// 位置パラメータを使用した例
[AttributeUsage( AttributeTargets.All )]
class UsingPositionalParameterAttribute : Attribute
{
}

// 位置パラメータと名前付きパラメータを使用した例
[AttributeUsage( AttributeTargets.All, AllowMultiple = true )]
class UsingNamedParameterAttribute : Attribute
{
}

using System;



// 全ての要素を対象とした属性
[AttributeUsage( AttributeTargets.All )]
class UseForAllTargetsAttribute : Attribute
{
}

// メソッドに対して複数回指定できる属性
[AttributeUsage( AttributeTargets.Method, AllowMultiple = true )]
class UseForMethodAllowMultipleAttribute : Attribute
{
}

// 派生クラス・構造体に対して指定できる属性
[AttributeUsage( AttributeTargets.Struct | AttributeTargets.Class, Inherited = true )]
class UseForStructAndDerivedClassAttribute : Attribute
{
}

// これらの属性を適用したクラス
[UseForAllTargetsAttribute, UseForStructAndDerivedClass]
class UsingAttributeClass
{
    [UseForMethodAllowMultiple, UseForMethodAllowMultiple]
    public void UsingAttributeMethod()
    {
    }
}






// 位置パラメータとしてint型の値を三つとる属性  (AttributeUsage属性の適用を省略)
class ThreeArgumentsAttribute : Attribute
{
    public ThreeArgumentsAttribute( int x, int y, int z)
    {
    }
}

// ThreeArgumentsAttribute を適用したクラス
[ThreeArguments( 1, 2, 3 )]
class UsingThreeArgumentClass
{
}





// 名前付きパラメータで指定する属性 (AttributeUsage属性の適用を省略)
class NamedParameterAttribute : Attribute
{
    public string StringValue = null;
    public int    IntValue    = 0;
    public Type   TypeValue   = null;
}

// NamedParameterAttribute を適用したクラス
[NamedParameter( StringValue = "String value", TypeValue = typeof( UsingNamedParameterClass ) )]
class UsingNamedParameterClass
{
}

using Attributes;
using System;
using System.Reflection;

// アセンブリに対する属性の適用
[assembly: Copyright( "santa marta", 2003 )]

namespace Attributes
{
    // カスタム属性
    [AttributeUsage(AttributeTargets.Assembly | 
                    AttributeTargets.Class |
                    AttributeTargets.Method,
                    Inherited = true)]
    public class CopyrightAttribute : Attribute
    {
        private string m_Author;
        private int    m_Year;

        public CopyrightAttribute( string author, int year )
        {
            m_Author = author;
            m_Year   = year;
        }

        public string Author
        {
            get { return m_Author; }
        }

        public int Year
        {
            get { return m_Year; }
        }

        public override string ToString()
        {
            return "CopyrightAttribute: Copyright(C) " + m_Year.ToString() + " " + m_Author;
        }
    }

    // アプリケーションのエントリーポイントを提供するクラス
    class ApplicationEntrance
    {
        [STAThread]
        static void Main(string[] args)
        {

            // 現在実行中のアセンブリを取得する
            Assembly assm = Assembly.GetExecutingAssembly();

            // アセンブリに指定されている属性を取得する
            object[] attrs = assm.GetCustomAttributes( typeof( Attribute ), true );

            // 属性を列挙
            foreach ( Attribute attr in attrs )
            {
                Console.WriteLine( attr );
            }

        }
    }

}

using System.Reflection;
using System.Runtime.CompilerServices;

//
// アセンブリに関する一般情報は以下の 
// 属性セットを通して制御されます。アセンブリに関連付けられている 
// 情報を変更するには、これらの属性値を変更してください。
//
[assembly: AssemblyTitle("")]
[assembly: AssemblyDescription("")]
[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("")]
[assembly: AssemblyProduct("")]
[assembly: AssemblyCopyright("")]
[assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")]        

//
// アセンブリのバージョン情報は、以下の 4 つの属性で構成されます :
//
//      メジャー バージョン
//      マイナ バージョン 
//      ビルド番号
//      リビジョン
//
// 下にあるように、'*' を使って、すべての値を指定するか、 
// ビルドおよびリビジョン番号を既定値にすることができます :

[assembly: AssemblyVersion("1.0.*")]

//
// アセンブリに署名するには、使用するキーを指定しなければなりません。 
// アセンブリ署名に関する詳細については、Microsoft .NET Framework ドキュメントを参照してください。
//
// 下記の属性を使って、署名に使うキーを制御します。 
//
// メモ : 
//   (*) キーが指定されないと、アセンブリは署名されません。
//   (*) KeyName は、コンピュータにインストールされている
//        暗号サービス プロバイダ (CSP) のキーを表します。KeyFile は、
//       キーを含むファイルです。
//   (*) KeyFile および KeyName の値が共に指定されている場合は、 
//       以下の処理が行われます :
//       (1) KeyName が CSP に見つかった場合、そのキーが使われます。
//       (2) KeyName が存在せず、KeyFile が存在する場合、 
//           KeyFile にあるキーが CSP にインストールされ、使われます。
//   (*) KeyFile を作成するには、sn.exe (厳密な名前) ユーティリティを使ってください。
//       KeyFile を指定するとき、KeyFile の場所は、
//       プロジェクト出力 ディレクトリへの相対パスでなければなりません。
//       パスは、%Project Directory%\obj\<configuration> です。たとえば、KeyFile がプロジェクト ディレクトリにある場合、
//       AssemblyKeyFile 属性を 
//       [assembly: AssemblyKeyFile("..\\..\\mykey.snk")] として指定します。
//   (*) 遅延署名は高度なオプションです。
//       詳細については Microsoft .NET Framework ドキュメントを参照してください。
//
[assembly: AssemblyDelaySign(false)]
[assembly: AssemblyKeyFile("")]
[assembly: AssemblyKeyName("")]
 です。たとえば、KeyFile がプロジェクト ディレクトリにある場合、
//       AssemblyKeyFile 属性を 
//       [assembly: AssemblyKeyFile("..\\..\\mykey.snk")] として指定します。
//   (*) 遅延署名は高度なオプションです。
//       詳細については Microsoft .NET Framework ドキュメントを参照してください。
//
[assembly: AssemblyDelaySign(false)]
[assembly: AssemblyKeyFile("")]
[assembly: AssemblyKeyName("")]]]>

using System;
using System.Diagnostics;
using System.Reflection;

namespace Attributes
{
    // 属性を適用されたクラス
    [Copyright( "santa marta", 2003 ), DebuggerStepThrough()]
    class UsingAttributeClass
    {
        [Copyright( "Some programmer", 2003 )]
        public int ReturnsIntMethod()
        {
            return 0;
        }

        [Copyright( "Old programmer", 1999 )]
        public string ReturnsStringMethod()
        {
            return "";
        }

        [Copyright( "Another programmer", 2001 )]
        public void ReturnsVoidMethod()
        {
        }
    }

    // アプリケーションのエントリーポイントを提供するクラス
    class ApplicationEntrance
    {
        [STAThread]
        static void Main(string[] args)
        {
            // どこかでインスタンスが作成されたとする
            UsingAttributeClass inst = new UsingAttributeClass();

            // そのインスタンスの型情報を取得する
            Type t = inst.GetType();

            // 型に指定されているCopyrightAttribute属性を取得する
            object[] attrs = t.GetCustomAttributes( typeof( CopyrightAttribute ), true );

            // 列挙する
            Console.WriteLine( t.Name + " に指定されている属性" );

            foreach ( CopyrightAttribute attr in attrs )
            {
                Console.WriteLine( attr );
            }

            Console.WriteLine();


            // 型情報からその型のメソッド情報を取得する
            MethodInfo[] methods = t.GetMethods();

            // 全てのメソッドに対して
            foreach ( MethodInfo method in methods )
            {
                // 属性を取得
                attrs = method.GetCustomAttributes( typeof( CopyrightAttribute ), true );

                if ( 0 < attrs.Length )
                {
                    // 列挙する
                    Console.WriteLine( t.Name +"." + method.Name + "() に指定されている属性" );

                    foreach ( CopyrightAttribute attr in attrs )
                    {
                        Console.WriteLine( "\t" + attr );
                    }
                }
                else
                {
                    Console.WriteLine( t.Name +"." + method.Name + "() には属性は指定されていません" );
                }
            }
        }
    }
}