【转】编写高质量代码改善C#程序的157个建议——建议129：泛型类型参数要以T作为前缀

 

建议129：泛型类型参数要以T作为前缀

作为一种约定，泛型类型的参数要以T作为前缀。如委托声明：

Action<T1,T2>

其中，泛型类型参数名不应该处理成：

Action<Arg1,Arg2>

当然，这仅仅是一种习惯，若果使用第二种命名方式，编译器并不会报错，但是作为调用者，也许不能意识到这里是一个泛型类型参数。这个问题在为类型指定泛型的时候尤为明显，因为为类型指定泛型类型参数的声明不会出现在公开的接口中，如：

    class SampleClass<T>
    {
        public void SampleMethod(T t)
        {
            
        }

        public void SampleMethod2<T1>(T1 t)
        {
            
        }
    }

在这个例子中，对两个方法的调用代码如下：

            SampleClass<string> sampleClass=new SampleClass<string>();
            sampleClass.SampleMethod("123");
            sampleClass.SampleMethod2<string>("123");

我们在使用SampleMethod方法的时候，如果将类型的泛型由T改为Person，很容易在类型内部会不自觉人为Person是一个类型，而不是一个泛型。而SampleMethod2带来的困扰就会少一些，因为泛型在使用它的地方被声明了。当然，无论如何，我们都不应该为泛型指定一个模棱两可的命名。记住，只要是泛型，就应该以T作为前缀命名。

 

 

转自：《编写高质量代码改善C#程序的157个建议》陆敏技