『 再看.NET7』泛性特性使用场景

使用特性，可以有效地将元数据或声明性信息与代码（程序集、类型、方法、属性等）相关联。 将特性与程序实体相关联后，可以在运行时使用反射这项技术查询特性。

​​https://learn.microsoft.com/zh-cn/dotnet/csharp/programming-guide/concepts/attributes/​​

　　上面是引自微软官方文档，关于特性的作用的描述。在.NET7中，可以给特性定义泛型了。这看起来似乎和特性的参数有矛盾，因为特性的参数是以下类型。

• 简单类型:bool，byte，char，double，float，int，long，sbyte，short，string，uint，ulong，ushort。
• object类型。
• System.Type类型。
• 枚举类型。
• 上面类型的一维数组。

　　看下面的例子，定义泛型参特性，想把T当构造函数参数，也就是特性的必值参数使用，但是这里报错了，信息是：这不是有效的特性参数类型，这也就是上面说的特性参数与泛型有矛盾的地方。

/// <summary>
/// 自定义类
/// </summary>
public class MyType
{
}
/// <summary>
/// 泛型特性
/// </summary>
/// <typeparam name="T"></typeparam>
public class GenericAttribute<T> : Attribute where T : class, new()
{
    public GenericAttribute(T t)
{
    }
}
/// <summary>
/// 使用泛型特性
/// </summary>
[Generic<MyType>(new MyType())]
public class A
{
}

　　其实泛型特性主要是提供声明性信息的，不能传A类型的实例对像是可以理解的，至少能把A类型这个声明性信息带入。所以这就对泛特性的使用姿势有要求了。

　　还是先看一下面的一个用法吧。

using System.Reflection;
using System.Text;

var person = new Person();
person.ID = 10;
person.Name = "桂素伟";
Console.WriteLine(person);

var order = new Order();
order.ID = 10;
order.Name = "批发";
order.Pirce = 12.34m;
Console.WriteLine(order);

[AttributeUsage(AttributeTargets.Class, AllowMultiple = false)]
public class DataFormatAttribute<T> : Attribute
{
}
public interface IFormatter
{
    string ConvertTo(object obj);
}

public class JsonFormatter : IFormatter
{
    public string ConvertTo(object obj)
    {
        return System.Text.Json.JsonSerializer.Serialize(obj);
    }
}
public class XmlFormatter : IFormatter
{
    public string ConvertTo(object obj)
    {
        var ser = new System.Xml.Serialization.XmlSerializer(obj.GetType());
        using var memory = new MemoryStream();
        ser.Serialize(memory, obj);
        var bytes = memory.GetBuffer();
        return Encoding.UTF8.GetString(bytes, 0, bytes.Length);
    }
}

public abstract class Entity
{
    public override string? ToString()
    {
        var type = this.GetType();
        foreach (var attr in type.GetCustomAttributes(false))
        {
            if (attr.GetType().IsGenericType)
            {
                var pars = attr.GetType().GenericTypeArguments;
                foreach (var par in pars)
                {
                    var format = Activator.CreateInstance(par) as IFormatter;
                    return format?.ConvertTo(this);
                }
            }
        }
        return null;
    }
}

[DataFormat<JsonFormatter>()]
public class Person : Entity
{
    public int ID { get; set; }
    public string? Name { get; set; }
}
[DataFormat<XmlFormatter>()]
public class Order : Entity
{
    public int ID { get; set; }
    public string? Name { get; set; }
    public decimal Pirce { get; set; }
}

　　例子很简单，就是把实体类的格式化器声明在实体定义阶段，最终通过重构ToString函数，实现对泛特性的类型参数反射和使用。由此例可以大体看出，泛型特性的T，一般是通过反射创建实例而来的，而不是通过定义实例化而来的，所以这个类型一般是使用其中的方法等功能，而非属性类的数据。

　　想要更快更方便的了解相关知识，可以关注微信公众号