共用方式為

自訂配接器設定設計工具

  • 發行項

您需要在 .NET 類別庫中建置自訂的設計工具。 您可以將這些設計工具整合到配接器的 DLL 中，或是另外建置 DLL。 在建置設計工具組件之後，必須透過裝飾而加以參考，就如同描述或類別一樣。 參考需包括組件的規格以及使用的完整格式類別名稱。

這些裝飾支援兩種參考特定自訂設計工具的方式：當做全域組件快取中的通用群組件，或作為位於磁片上的外部元件。

注意

有兩個可能的設計階段元件路徑：您可以在 XSD 本身的組態 XSD 中指定類型編輯器和轉換器的絕對路徑， (相對路徑不支援) ，或者您可以將類型編輯器和轉換器儲存在全域組件快取中，而不需要絕對路徑。

全域組件快取設計工具的使用

全域組件快取會依照組件名稱、公開金鑰、版本和文化特性來儲存組件。 因為這個原因，所以建議您：

  1. 產生公開金鑰檔案，並將此檔案加入 AssemblyInfo.cs 檔案。

  2. 在 AssemblyInfo.cs 檔案中指定特定的版本。

    您可以將組件拖曳到全域組件快取中，或使用 GACUTIL 將組件加入至全域組件快取中。

    若要使用此設計工具，請指定完整格式的類別名稱、逗號，以及全域組件快取的組件項目 (組件名稱、版本、文化特性和公開金鑰 Token)，以做為裝飾的值。 針對TypeConverter實作使用 <UITypeEditor實作的編輯器 > 裝飾和 < 轉換器 > 裝飾。

    下列程式碼範例將示範如何在 XSD 檔案中初始化自訂的設計工具。

<xs:element name="Global" type="xs:string">  
   <xs:annotation>  
      <xs:appinfo>  
         <baf:designer>  
            <baf:category>GAC Designer Component</baf:category>  
            <baf:editor>AdapterManagement.ComponentModel. PasswordUITypeEditor, AdapterManagement, Version=1.0.1.0, Culture=neutral, PublicKeyToken=f0db50abb0615c18</baf:editor>  
         </baf:designer>  
      </xs:appinfo>  
   </xs:annotation>  
</xs:element>  
      </xs:sequence>

外部組件的安裝與使用

如果是外部組件，裝飾會包含選擇性的屬性組件，這些組件可以為含有所要之設計工具的組件指定其完整路徑及名稱。

下列程式碼範例將示範如何在外部組件中初始化自訂的設計工具：

<xs:element name="External" type="xs:string">  
   <xs:annotation>  
      <xs:appinfo>  
         <baf:designer>  
            <baf:category>External Designer Component</baf:category>  
            <baf:converter assembly="C:\source\private\Adapter\Framework\Designer\bin\Debug\Designer.External.dll">Designer.External.DesignerTypeConverter</baf:converter>  
         </baf:designer>  
      </xs:appinfo>  
   </xs:annotation>  
</xs:element>

另請參閱

配接器設定的自訂下拉式編輯器
配接器設定的自訂強制回應對話方塊編輯器
配接器設定的自訂類型轉換器
配接器的進階設定元件