CodeSmith基礎（一）

       請你們耐心看完全部的基礎文章，前兩篇網上發表的比較多，是CodeSmith英文幫助文檔的第一篇，我後面寫的基礎是將其餘全部的英文幫助所有翻譯出來了，所有爲本人手寫翻譯，但願對你們有所幫助

        建立好一個模板後第一步要指明這是一個C#語言的模板。

< %@ CodeTemplate  Language ="C#"  TargetLanguage ="C#"
      Description ="Generates a class including a special informational header"  % >

        第二步，咱們要指明模板在生成代碼時的屬性，即生成代碼須要的輸入值變量。

< %@ Property  Name ="NameSpace"  Type ="String"
      Category ="Context"
      Description ="The namespace to use for this class"  % >

        如上邊所示，在進行代碼生成時，在CodeSmith Explorer中選擇模板後生成代碼的窗口中，變量的名稱爲NameSpace，類型是String，類別是Context，當用戶選中這個屬性時對於屬性的描述Description。
        咱們能夠按照C#語言的語法去使用定義的變量，例如：

///////////////////////////////////////////////////////////////////////////////////////
//  File: <%=ClassName%>.cs

        例以下面這個例子模板使用了上面介紹的知識。Test.cst

< %@ CodeTemplate  Language ="C#"  TargetLanguage ="C#"
      Description ="Generates a class including a special informational header"  % >
 
< %@ Property  Name ="NameSpace"  Type ="String"
      Category ="Context"
      Description ="The namespace to use for this class"  % >
 
< %@ Property  Name ="ClassName"  Type ="String"
      Category ="Context"
      Description ="The name of the class to generate"  % >
 
< %@ Property  Name ="DevelopersName"  Type ="String"
      Category ="Context"
      Description ="The name to include in the comment header"  % >

///////////////////////////////////////////////////////////////////////////////////////
//  File: <%=ClassName%>.cs
//  Description: Enter summary here after generation.
//  ---------------------
//  Copyright © <%= DateTime.Now.Year %> Our Client
//  ---------------------
//  History
//     <%= DateTime.Now.ToShortDateString() %>    <%= DevelopersName%>    Original Version
///////////////////////////////////////////////////////////////////////////////////////
 
using  System;
 
namespace   <%= NameSpace  %>
{
       ///   <summary>
       ///  Summary description for  <%=ClassName %> .
       ///   </summary>
       public   class   <%= ClassName  %>
      {
             public   <%= ClassName  %> ()
            {
                   //
                   //  TODO: Add constructor logic here
                   //
            }
      }
}

而後咱們在CodeSmith Explorer中雙擊這個模板就會看到相應的屬性界面，這裏的屬性均是咱們在前邊定義的屬性。

按下Generate按鈕生成，便可實現一個簡單的類代碼的生成。

 1 /**/ ///////////////////////////////////////////////////////////////////////////////////////
 2 //  File: MyClass.cs
 3 //  Description: Enter summary here after generation.
 4 //  ---------------------
 5 //  Copyright © 2003 Our Client
 6 //  ---------------------
 7 //  History
 8 //     12/2/2003    Mr. Smith    Original Version
 9 /**/ ///////////////////////////////////////////////////////////////////////////////////////
10  
11 using  System;
12  
13 namespace  MyNameSpace
14 {
15      /**//// <summary>
16      /// Summary description for MyClass.
17      /// </summary>
18      public class MyClass
19      {
20            public MyClass()
21            {
22                  //
23                  // TODO: Add constructor logic here
24                  //
25            }
26      }
27}

生成後的代碼便可放入Visual Studio .NET中使用，咱們使用CodeSmith的目的就是爲了快速高效的開發。