编写高质量代码改善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个建议》陆敏技

posted @ 2015-08-23 14:16  JesseLZJ  阅读(347)  评论(0编辑  收藏  举报