配置程式碼生成器

ConfigurationCodeGenerator 是一種工具，可用來向組態系統公開自定義通道實作。 這可讓自定義通道的使用者使用 .config 檔案來設定他們的通道，就像使用系統提供的系結，例如 NetTcpBinding，或者使用自定義系結 TcpTransportBindingElement 一樣。

當您撰寫自定義通道，並使用新的 BindingElement 或 Binding將它公開至程式設計模型時，您必須建立一組類別，才能使用 .config 檔案進行 BindingElement 或 Binding 設定。 您可以使用 ConfigurationCodeGenerator 工具來產生這些類別，並增強客戶體驗。

開始建置工具

1. 若要建置解決方案，請遵循 建置 Windows Communication Foundation 範例中的指示。

2. 建置方案會產生一個檔案：ConfigurationCodeGenerator.exe。 檔案SampleRun.cmd有範例命令行，示範如何使用此工具來產生 傳輸：UDP 範例的類別。

執行工具

1. 如果您有自訂 BindingElement 類型和自訂 Binding 類型，請在命令提示字元中輸入下列命令：

   ConfigurationCodeGenerator.exe /be:YourCustomBindingElementTypeName /sb:YourCustomStdBindingTypeName /dll:TheAssemblyWhereTheseTypesAreDefined
   

   或者，如果您只有自定義 BindingElement 類型，請輸入下列內容：

   ConfigurationCodeGenerator.exe /be:YourCustomBindingElementTypeName /dll: TheAssemblyWhereThisTypeIsDefined
   

   或者，如果您只有自定義 Binding 類型，請輸入下列內容：

   ConfigurationCodeGenerator.exe /sb:YourCustomStdBindingTypeName /dll:TheAssemblyWhereThisTypeIsDefined
   

   此命令會針對 BindingElement 產生三個.cs檔案（如果您指定 /be： 選項）、標準 Binding 有五個.cs檔案（如果您指定 /sb： 選項），以及一個 .xml 檔案。

   1. 如果您使用 /be 選項，其中一個 .cs 檔案會為您的綁定元素實作 BindingElementExtensionSection。 此程式代碼會將您 BindingElement 公開至組態系統，讓其他自定義系結可以使用您的綁定項。 其他檔案具有代表預設值和常數的類別。 這些檔案有 //TODO 批注可提醒您更新預設值。

   2. 如果您指定了 /sb 選項，則其中兩個 .cs 檔案會分別實作 StandardBindingElement 和 StandardBindingCollectionElement 的功能，這使您的標準綁定對設定系統公開。 其他檔案具有代表預設值和常數的類別。 這些檔案有 //TODO 批注可提醒您更新預設值。

      如果您指定了 /sb: 選項，則 CodeToAddTo<YourStdBinding>.cs 會包含一些程式碼，您必須將這些程式碼手動新增至實作您標準系結的類別中。

   SampleConfig.xml 檔案包含您必須新增至組態檔的組態碼，以註冊在上一個步驟 1 或 2 中定義的處理程式。