自定義C#元數據與版本控制

在C#中，可以使用自定義屬性（Custom Attributes）來為程序集、類型、方法等元素添加元數據

1. 創建一個自定義屬性：

using System;

[AttributeUsage(AttributeTargets.All, AllowMultiple = true)]
public class CustomMetadataAttribute : Attribute
{
    public string Key { get; set; }
    public string Value { get; set; }

    public CustomMetadataAttribute(string key, string value)
    {
        Key = key;
        Value = value;
    }
}

2. 將自定義屬性應用于程序集、類型、方法等元素：

using System;

[assembly: CustomMetadata("AssemblyMetadataKey", "AssemblyMetadataValue")]

namespace CustomMetadataExample
{
    [CustomMetadata("NamespaceMetadataKey", "NamespaceMetadataValue")]
    public class MyClass
    {
        [CustomMetadata("ClassMetadataKey", "ClassMetadataValue")]
        public void MyMethod()
        {
            // ...
        }
    }
}

3. 讀取自定義屬性的值：

using System;
using System.Linq;
using System.Reflection;

class Program
{
    static void Main(string[] args)
    {
        // 獲取程序集
        Assembly assembly = typeof(Program).Assembly;

        // 獲取自定義屬性并讀取值
        var customAttributes = assembly.GetCustomAttributes<CustomMetadataAttribute>();
        foreach (var attribute in customAttributes)
        {
            Console.WriteLine($"Key: {attribute.Key}, Value: {attribute.Value}");
        }

        // 獲取類型
        Type myClassType = typeof(MyClass);

        // 獲取自定義屬性并讀取值
        customAttributes = myClassType.GetCustomAttributes<CustomMetadataAttribute>();
        foreach (var attribute in customAttributes)
        {
            Console.WriteLine($"Key: {attribute.Key}, Value: {attribute.Value}");
        }

        // 獲取方法
        MethodInfo myMethodInfo = myClassType.GetMethod("MyMethod");

        // 獲取自定義屬性并讀取值
        customAttributes = myMethodInfo.GetCustomAttributes<CustomMetadataAttribute>();
        foreach (var attribute in customAttributes)
        {
            Console.WriteLine($"Key: {attribute.Key}, Value: {attribute.Value}");
        }
    }
}

關于版本控制，可以使用Semantic Versioning（語義化版本）規范。這是一種廣泛采用的版本控制策略，它使用三位數字表示版本號，格式為major.minor.patch。其中：

• major：主版本號，當有重大更改時遞增。
• minor：次版本號，當有向后兼容的新功能時遞增。
• patch：修訂號，當有向后兼容的錯誤修復時遞增。

要在C#項目中實現版本控制，可以在項目的AssemblyInfo.cs文件中設置程序集版本：

using System.Reflection;

[assembly: AssemblyVersion("1.0.0")]
[assembly: AssemblyFileVersion("1.0.0")]

或者在項目文件（.csproj）中設置：

 <PropertyGroup>
   <Version>1.0.0</Version>
  </PropertyGroup>
</Project>

在發布新版本時，只需更新這些版本號即可。