根據現有 C#程式碼檔案生成擴充套件程式碼檔案的想法

iDotNetSpace發表於2009-04-09

看到這標題的朋友可能搞不懂到底在搞什麼,不過不要緊有興趣的朋友可以先了解一下IVsSingleFileGenerator到底是用來做什麼用的實現自定義的VsSingleFileGenerator ;在vs.net裡提供一個IVsSingleFileGenerator介面可以方便地為專案檔案生成附屬檔案,如剛才那文章提到的根據XML檔案自動生成一個附屬的C#程式碼檔案;當然這個IVsSingleFileGenerator並不只是針對XML檔案,可以是隨便為任何專案檔案生成附屬檔案你只要在檔案屬性中設定相關Custom Tools就可以了.


      為什麼在這裡我提出在程式碼檔案的基礎上再生相關的程式碼附屬檔案呢,為什麼不直接在原始碼檔案寫完整就可以了;原因很簡單因為手寫程式碼是沒有電腦來得快,最主要一個原因是基於XML的IVsSingleFileGenerator在某方面不好所以才採用基於程式碼檔案的方式作為程式碼描述模板.用XML描述在現情況碰到的問題,在我的資料持久層裡是採用XML結合IVsSingleFileGenerator來生成相關實體類的.

內容大概如下:
<SmarkDatamodels xmlns="http://SmarkData.cn/model.xsd" >

    <Class Name="Customer" Table="vp_Customer">

<ID Name="CustomerID" Type="System.Int64"/>

<Property Name="UserName" Type="System.String" Comment="使用者名稱"/>

<Property Name="UserPWD" Type="System.String" Comment="使用者密碼"/>

<Property Name="CustomerType" Type="System.Int32" Comment="客戶型別"/>

<Property Name="CustomerName" Type="System.String" Comment="自定義名"/>

<Property Name="Sex" Type="System.Boolean" Comment="性別"/>

<Property Name="Region" Type="System.String" Comment="地區"/>

<Property Name="City" Type="System.String" Comment="城市"/>

<Property Name="IDCard" Type="System.String" Comment="身份證號"/>

<Property Name="EMail" Type="System.String" Comment="電子郵件"/>

<Property Name="Phone" Type="System.String" Comment="電話"/>

Class>

SmarkDatamodels>
VsSingleFileGenerator會根據XML生成以下相關實體:
        /// 

        /// 使用者名稱

        /// 

        public virtual string UserName {

            get {

                return this.mUserName;

            }

            set {

                this.mUserName = value;

                this.EntityState.FieldChange("UserName");

            }

        }

        

        /// 

        /// 使用者密碼

        /// 

        public virtual string UserPWD {

            get {

                return this.mUserPWD;

            }

            set {

                this.mUserPWD = value;

                this.EntityState.FieldChange("UserPWD");

            }

        }

        

        /// 

        /// 客戶型別

        /// 

        public virtual int CustomerType {

            get {

                return this.mCustomerType;

            }

            set {

                this.mCustomerType = value;

                this.EntityState.FieldChange("CustomerType");

            }

     }
VsSingleFileGenerator有個不好的地方就是當主檔案修改後會重新生成附屬檔案,這樣就導致你無法修改程式碼檔案.如果想為某些屬性成員新增Attribute來處理一些功能基本是沒辦法的.

如新增成員資料驗證:

        [NotNull]

        [Length("5","16","使用者名稱長度必須在5-16個字元內!")]

        public string UserName

        {

            get;

            set;

        }

即使能解決VsSingleFileGenerator生成附屬檔案衝突問題;但也要面對另一個問題,就如何擴充套件XML來處理這些擴充套件呢,新增XMLSchema擴充套件描述規則,重寫VsSingleFileGenerator程式碼生成部份;這樣下來沒多久我估計自己會瘋了....

實際情況新增不同Attribute來擴充套件輔助功能是很常見的事情,就一個驗證來說根據實際情況就有很多情況,類構造方式也不一樣.就針對這些情況來擴充套件XMLSchema和重寫VsSingleFileGenerator帶來的工作量就不用說了,還有一個問題就是XML並不能提供型別編譯的保證這樣對XML的質量是很難保證.

 

經過了一段時間的思考發現為什麼不直接用程式碼作為原模板呢,這樣就能得到IDE的支援,強在編譯器的支援下保證型別輸入規則的有效性.以下是本人實現的簡單生成模型:

    [Table]

    interface IUser

    {

        [ID]

        string UserName { getset; }

        string BirthDate { getset; } 

        string Region { getset; }

        string Remark { getset; }

    }

生成的相關程式碼

    [Table]

      [Serializable]

    public class User:Smark.Data.Mappings.DataObject

    {

        [ID]

        public string UserName { getreturn mUserName;} set{mUserName=value;EntityState.FieldChange("UserName");} }

private string mUserName;

public static Smark.Data.FieldInfo userName = new Smark.Data.FieldInfo("User","UserName");

        public string BirthDate { getreturn mBirthDate;} set{mBirthDate=value;EntityState.FieldChange("BirthDate");} } 

private string mBirthDate;

        public string Region { getreturn mRegion;} set{mRegion=value;EntityState.FieldChange("Region");} }

private string mRegion;

        public string Remark { getreturn mRemark;} set{mRemark=value;EntityState.FieldChange("Remark");} }

private string mRemark;

    }

}

這樣的話即使我們如何給屬性新增Attribute都不會帶來程式碼上的修改,VsSingleFileGenerator只對屬性作一個模板生成其他內容搬過來就可以了:)

來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/12639172/viewspace-586876/,如需轉載,請註明出處,否則將追究法律責任。

相關文章