Revit SDK 包含兩個範例資料夾：
\Revit SDK <版本>\Software Development Kit\Samples\...
\Revit SDK <版本>\Software Development Kit\Macro Samples\...
SDK 的 \Samples\ 資料夾中的程式使用標準 Revit API。我們將這些範例稱為「SDK 範例程式碼」，與 Revit 巨集範例不同。
如果您要在巨集中使用 SDK 範例程式碼，請視需要進行修改。遵循本節中的步驟。對於程式設計語言，我們將展示 C# 範例。不過，這些指示也適用於 VB.NET 版本的 SDK 範例。
初始步驟
將標準 API 範例從 SDK 移轉到 Revit 巨集 IDE 專案的初始步驟，與〈將巨集整合至 Revit IDE〉一節中的步驟類似。但此時不是從 SDK 的 \Macro Samples\<範例名稱>\... 資料夾複製檔案，而是從 SDK 的 \Samples\<範例名稱>\... 資料夾複製檔案。
若要檢閱，請執行以下步驟：
- 在 IDE 中，加入必要參考。
- 在 IDE 中，建立用於存放所移轉 SDK 範例的資料夾。
- 在 Windows 檔案總管中，將 SDK 標準 API 範例的檔案複製到對應的檔案系統資料夾。
- 在 IDE 中，將現有檔案加入到巨集專案。
更新 SDK 範例的程式碼
在 Revit 巨集 IDE 中，未提供或無法使用 IExternalCommand 介面。在 SDK 標準 API 範例程式碼中，您必須更新從此介面所繼承的類別：
- 移除方法參數並傳回 Execute 方法。
- 更新與 ExternalCommandData 相關的其他程式碼。
未經編輯的程式碼範例
下列程式碼片段來自於使用標準 Revit API 的程式：
經過編輯的程式碼範例
在 Revit 巨集 IDE 中，我們必須更新程式碼，如下所示。此範例展示應用程式層級巨集。方法 RunSampleRooms() 是這個巨集範例的項目。請注意，我們已使用 this 指標來取代 commandData.Application。
SDK 標準 API 範例的其他移轉注意事項
- 依預設，SDK 範例名稱空間是：Revit.SDK.Samples。<SampleName>.CS。當您編輯來自 SDK 標準 API 範例的範例程式碼時，請務必變更 Revit IDE 的名稱空間。例如，在 ThisApplication.cs 中：
namespace AppCSharp.csproj
- Revit IDE 專案中的預設專案參考只包含基本參考，例如 Revit.Proxy。請記得加入其他必要參考。例如，執行展示使用者介面的範例時，您必須加入 System.Windows.Forms 和 System.Drawing 參考。
- 有些範例擁有必須在 resources.resx 檔案中定義的資源。GridCreation 是屬於此類的一個範例。如果您將 GridCreation 的 SDK 標準 API 範例移轉到 Revit IDE，請務必設定 resx 性質。
- Revit 巨集 IDE 不支援專案建立相依性。如果您要使用其他 DLL，則必須在 Revit 巨集 IDE 外部編譯相依範例專案。例如，在 SDK 標準 API 範例中，有幾個與「檢視器」相關的範例，例如 AnalyticalViewer 和 RoomViewer，這些檢視器會相依於 RevitViewer 的參考。
但是，由於 Revit IDE 中的限制，我們無法設定專案相依性，並且無法移轉 RevitViewer 範例。因此，您必須將 RevitViewer 編譯為獨立的 SDK 範例，然後在 Revit IDE 專案中加入其 DLL 作為參考：
- 將 SDK 標準 API 範例移轉到 Revit IDE 時，請勿複製任何解決方案檔案 (*.sln*) 或現有專案檔案 (*.csproj 或 *.vbproj)。
- 在 Revit IDE 中無法使用與工具列相關的範例。