共用方式為

ConfigurationCodeGenerator

  • 發行項

ConfigurationCodeGenerator 是可供您用來公開自訂通道實作給組態系統的工具。這將允許您的自訂通道使用者使用 .config 檔案設定通道，就像平常使用 TcpTransportBindingElement 來設定系統提供的繫結 (例如 NetTcpBinding) 或自訂繫結一般。

使用新的 BindingElement 或 Binding 撰寫自訂通道並將它公開給程式設計模型時，您必須建立一組類別，讓 BindingElement 或 Binding 可透過使用 .config 檔案來加以設定。您可以使用 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 中定義) 的組態檔中。

Send comments about this topic to Microsoft.
© 2007 Microsoft Corporation. All rights reserved.