開發自訂 ForEach 列舉值的使用者介面

適用於：SQL ServerAzure Data Factory 中的 SSIS Integration Runtime

在您已覆寫可提供自訂功能的基底類別之屬性與方法的實作之後，可能會想要針對 Foreach 列舉值建立自訂使用者介面。 如果您未建立自訂使用者介面，使用者可以使用 [屬性] 視窗來設定新的自訂 Foreach 列舉值。

在自訂的使用者介面專案或是組件中，您可以建立可實作 ForEachEnumeratorUI 的類別。 這個類別衍生自 System.Windows.Forms.UserControl，通常它是用於建立複合控制項，以主控其他的 Windows Form 控制項。 在 Foreach 迴圈編輯器中，您建立的控制項是顯示在 [集合] 索引標籤的 [列舉值設定] 區域中。

重要

在簽署和組建自訂使用者介面，以及在全域組件快取中安裝它之後 (如建立、部署和偵錯自訂物件所述)，請記得在 DtsForEachEnumeratorAttribute 的 UITypeName 屬性中提供這個類別的完整名稱。

撰寫使用者介面控制項類別的程式碼

初始化使用者介面

您會覆寫 Initialize 方法來快取主機物件的參考，以及連線管理員集合與定義在封裝中之變數的參考。

在使用者介面控制項上設定屬性

衍生使用者介面類別的 UserControl 類別，是用來作為複合控制項以主控其他的 Windows Form 控制項。 因為這個類別會主控其他的控制項，所以您可以設計自訂使用者介面，方法是在任何 Windows Form 應用程式中，拖放控制項、排列它們、設定其屬性以及在執行階段回應其事件。

節省設定

您會覆寫 SaveSettings 方法，以便在使用者關閉編輯器時，從控制項將使用者選取的值複製到列舉值的屬性。

另請參閱

建立自訂的 Foreach 列舉值
撰寫自訂 Foreach 列舉值的程式碼