實作單一檔案產生器
自訂工具 (有時稱為單一檔案產生器) 可用來擴充 Visual Studio中 的 Visual Basic和Visual C# 專案系統。 自訂工具是實作 IVsSingleFileGenerator 介面的 COM 元件。 使用此介面,自訂工具會將單一輸入檔案轉換成單一輸出檔案。 轉換的結果可能是原始程式碼,或是任何其他有用的輸出。 自訂工具產生程式碼檔案的兩個範例是根據視覺化設計工具中的變更而產生的程式碼,和使用 Web 服務描述語言 (WSDL) 產生的檔案。
載入自訂工具或儲存輸入檔案時,專案系統會呼叫 Generate 方法,並將參考傳遞至 IVsGeneratorProgress 回呼介面,讓工具向使用者報告其進度。
自訂工具產生的輸出檔案會新增至具有輸入檔案相依性的專案。 專案系統會根據自訂工具實作 DefaultExtension 所傳回的字串,自動判斷輸出檔案的名稱。
自訂工具必須實作 IVsSingleFileGenerator 介面。 或者,自訂工具支援 IObjectWithSite 介面以從輸入檔案以外的來源擷取資訊。 在任何情況下,必須先向系統或在 Visual Studio 本機登錄中註冊自訂工具,才能使用自訂工具。 如需註冊自訂工具的詳細資訊,請參閱註冊單一檔案產生器。