通过

ConfigurationCodeGenerator

  • 项目

ConfigurationCodeGenerator 是一个工具，使用该工具可以向配置系统公开您的自定义通道实现。 这使自定义通道的用户可以通过使用 .config 文件来配置您的通道，就像配置系统提供的绑定（如 NetTcpBinding）或使用 TcpTransportBindingElement 的自定义绑定一样。

当您编写自定义通道并使用新的 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 中定义的处理程序的配置文件中。