共用方式為

ItemOperations.AddNewItem 方法

  • 發行項

將新項目加入至目前的專案。

命名空間：  EnvDTE
組件：  EnvDTE (在 EnvDTE.dll 中)

語法

'宣告
Function AddNewItem ( _
    Item As String, _
    Name As String _
) As ProjectItem

ProjectItem AddNewItem(
    string Item,
    string Name
)

ProjectItem^ AddNewItem(
    [InAttribute] String^ Item, 
    [InAttribute] String^ Name
)

abstract AddNewItem : 
        Item:string * 
        Name:string -> ProjectItem 

function AddNewItem(
    Item : String, 
    Name : String
) : ProjectItem

參數

  • Item
    型別：System.String
    選擇項。依據 UI 資源字串 (定義於下列「備註」一節) 之項目的虛擬路徑，或者偶爾以 "category\templatename" 格式顯示於 [新增檔案] 對話方塊的內容中。 Category 來自於對話方塊的左窗格，而 templatename 則來自於右窗格。例如，若要將新的 HTML 檔加入至 Visual Basic 專案，您可以使用 "General\HTML Page"。 如需詳細資訊，請參閱「備註」一節。
  • Name
    型別：System.String
    選擇項。項目加入至專案後所用來顯示的名稱。

傳回值

型別：EnvDTE.ProjectItem
ProjectItem 物件。

備註

AddNewItem 可以做為 [新增檔案] 對話方塊的模型。這個對話方塊的內容，因專案型別而異。有兩種方式可判斷要在 Item 參數中放置的值：查詢 [新增檔案] 對話方塊中的值，或查詢適當 UI 資源檔中的值。

若要使用第一種方法將項目加入至某些專案，請在 [新增檔案] 對話方塊中查看專案的可用項目。[新增檔案] 對話方塊有兩個窗格：[分類] 和 [範本]。AddNewItem 方法的 Item 參數會

使用 "category\templatename" 格式。Category 通常來自於對話方塊的左窗格 ([分類])，而 templatename 則來自於右窗格 ([範本])。例如，若要將新的 HTML 檔加入至 Visual Basic 專案，您可以使用 "General\HTML Page"。 不過，由於語言差異，因此這個參數的確切值並不一定會精確地反映於 [新增檔案] 對話方塊中。

取得 Item 參數之確切值更一致且可靠的方法是在每種程式語言的 UI 資源檔中查詢必要的字串，然後再使用這個值和所要加入的項目名稱 (如 [新增檔案] 和 [加入新項目] 對話方塊中所顯示)。例如，若要將新的 Visual Basic 類別檔加入至專案，便需要使用 AddNewItem("Visual Basic Items\Class", "test.vb")。而要將新的 Visual C# 類別檔加入至專案，則需要使用 AddNewItem("Visual C# Project Items\Class", test.cs");。

藉由下列方式可以找到字串 "Visual Basic Items" (以及其他語言項目)：

  • 如果是 Visual Basic 檔案，請開啟下列登錄機碼：HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\8.0\Projects\{F184B08F-C81C-45f6-A57F-5ABD9991F28F}\AdditemTemplates\TemplateDirs\{164B10B9-B200-11D0-8C61-00A0C91E29D5}\ /1。預設值為 #3082。

  • 使用 [資源編輯器] 在 Visual Studio 中開啟 msvbprjui.dll 檔案。若要這麼做，請在 [開啟] 功能表 (位於 [檔案] 功能表上) 上選取 [檔案]，瀏覽至這個檔案並加以開啟。開啟 [字串資料表] (String Table) 節點，便可以看到資源 ID 3082 設定為 "Visual Basic Items"。 這便是您可以放入 AddNewItem 呼叫中的字串。除非要使用的檔案名稱和資源 ID 不同，否則相同的程序也適用於 Visual C#、Visual C++ 和 Visual C# 專案系統。

下表為 UI 資源檔的資源 ID 和位置：

程式語言

UI 檔案名稱

類別的資源 ID

Visual Basic

…\Program Files\Microsoft Visual Studio 8\VB\Bin\1028\msvbprojUI.dll

3082

Visual C#

…\Program Files\Microsoft Visual Studio 8\VC#\VCSPackages\1028\csprjui.dll

2346

Visual C++

…\Program Files\Microsoft Visual Studio 8\VC\vcpackages\1033\VCProjectUI.dll

10007

範例

Sub AddNewItemExample()
   Dim ItemOp As ItemOperations
   ItemOp = DTE.ItemOperations
   ItemOp.AddNewItem("General\Text File", "A new text file")
End Sub

.NET Framework 安全性

請參閱

參考

ItemOperations 介面

EnvDTE 命名空間