專案擴充性簡介
只要在任何專案中加入下列 VSLangProj 組件的參考,就可以使用物件模型 (Object Model):VSLangProj.dll、VSLangProj2.dll、VSLangProj80.dll、VSLangProj90a.dll 和 VSLangProj100.dll 組件。如需詳細資訊,請參閱 HOW TO:使用加入參考對話方塊加入或移除參考。這表示物件模型可為增益集和任何的專案需要擴充 ide 或自動化 IDE 的型別。各主題中的範例都是用 Visual Basic 和 Visual C# 語言撰寫的。如需如何執行範例的詳細資訊,請參閱 HOW TO:編譯和執行 Automation 物件模型程式碼範例。增益集可以用任何一種 Visual Studio 裝載的語言撰寫,例如 Visual Basic、Visual C# 和 Visual C++。VSLangProj、VSLangProj2、VSLangProj80、VslangProj90 和 VslangProj100 成員的參考主題包含以上各種語言的語法。如需 Automation 專案類型和 Automation 功能的描述資訊,請參閱建立增益集和精靈。
VSLangProj 命名空間
這些命名空間包含 Visual Basic 和 Visual C# 專案的所有類別、介面和列舉。如需命名空間中所有物件的完整清單,請參閱 Visual Basic 和 Visual C# 的專案擴充性物件模型。
使用 VSLangProj 組件和 EnvDTE 組件時可能發生的錯誤
如果建立的專案要參考一個或多個 VSLangProj 組件和 EnvDTE 組件,在執行階段可能偶爾會收到下列錯誤訊息:
「未處理的例外狀況: System.IO.FileNotFoundException: 載入檔案 'EnvDTE, Version=7.0.3300.0 時發生錯誤」
這個錯誤是由於執行階段型別解析衝突所引起。換句話說,Visual Studio 2005 中所附的 EnvDTE 組件是 8.0.xx 版,但是專案的組態參考卻要尋找此組件的舊版,也就是 7.0.xx 版。若要修正這個問題,必須在專案的組態 (.config) 檔中加入新版 EnvDTE 組件的繫結重新導向。這麼做才能讓 Visual Studio 載入新版的 EnvDTE 組件,而且不再發生錯誤。
若要這麼做,請在專案中加入「應用程式組態檔」,然後以下列程式碼取代其內容:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-
com:asm.v1" appliesTo="v2.0.50318">
<dependentAssembly>
<assemblyIdentity name="EnvDTE" publicKeyToken=
"b03f5f7f11d50a3a"/>
<bindingRedirect oldVersion="7.0.3300.0"
newVersion="8.0.0.0"/>
</dependentAssembly>
</assemblyBinding>
</runtime>
</configuration>
VSProject2 物件
這個物件可以用來存取擴充性模型中的其他物件。DTE 物件是 Visual Studio Automation 模型中的最上層物件。在一般擴充性模型中,專案是以泛型 Project 物件表示。Project 物件具有 Object 屬性。屬性的型別則是在執行階段時依專案語言而決定。在 Visual Basic 或 Visual C# 專案中,Object 屬性會傳回 VSProject2 型別的物件。由於 Object 屬性的型別為 Object,所以您必須將參考轉換為 VSProject2 型別。有了 VSProject2 項目的參考之後,便可以管理專案的屬性、組態、檔案、資料夾、Imports 陳述式和參考。
如需詳細資訊,請參閱 VSProject2 物件簡介。
References 和 Reference 物件
包含在 VSProject2 物件中的 References 屬性會存放 Reference3 物件的集合。Reference3 物件表示專案參考,主要是支援 Remove 方法的唯讀物件。References 物件可以支援加入參考 (COM、.NET 組件、ActiveX 和其他專案) 以及引發事件 (加入、移除和變更參考)。
References 物件不包含專案的 Web 參考。專案的 Web 參考可經由存取 WebReferencesFolder 屬性的 ProjectItems 屬性來擷取。
如需詳細資訊和程式碼範例,請參閱 Reference 和 Reference3 物件、References 集合、References 屬性和 WebReferencesFolder 屬性。
Imports 物件
包含在 VSProject2 物件中的 Imports 屬性會保留適用於整個 Visual Basic 專案之 Imports 陳述式的集合。如果將 Imports 陳述式加入至此集合,就不需要將對應的 Imports 陳述式 (例如 Imports VSLangProj) 加入至程式碼檔。這個物件支援加入及移除 Imports 陳述式,並依加入和移除陳述式而引發事件。在 Visual C# 專案中沒有對等的項目,因此,如果將 VSProject2.Imports 屬性套用至 Visual C# 專案,將會傳回 Nothing 或 null。如需詳細資訊,請參閱 Imports。
VSProjectItem 和 BuildManager 物件
VSProjectItem 物件是指專案項目,相對於 VSProject2 物件所指的專案。在一般擴充性模型中,泛型 ProjectItem 物件表示專案項目。Object 屬性的型別為 Object,而在 Visual Basic 或 Visual C# 專案中,這個屬性的型別則為 VSProjectItem。VSProjectItem 物件包含連結至父代 (Parent) 專案項目和專案的屬性,以及強迫在該項目上執行自訂工具的方法。BuildManager 物件會處理自訂工具輸出。如需詳細資訊,請參閱 RunCustomTool 方法、BuildManager 物件簡介、VSProjectItem 物件和 BuildManager 物件。
Properties 屬性
一般擴充性模型在下列三個物件中具有 Properties 屬性:
Project 物件:這個物件中的屬性與 IDE 中專案 [屬性頁] 對話方塊之 [通用屬性] 索引標籤中的屬性相同。
Configuration 物件:這個物件中的屬性與 IDE 中專案 [屬性頁] 對話方塊之 [組態屬性] 索引標籤中的屬性相同。
ProjectItem 物件:這個物件中的屬性與在 [方案總管] 中選取專案項目之後出現在 [屬性] 視窗中的屬性相同。
在上述所有情況下,Properties 屬性都是 Property 型別之物件的集合。只要指定屬性以 1 起始的索引或屬性名稱,就可以從集合中取得 Property 物件。集合的內容則視語言別有所不同。在專案項目的案例中,內容將因項目是檔案或資料夾而有不同。