構成コード生成器

ConfigurationCodeGenerator は、カスタム チャネル実装を構成システムに公開するために使用できるツールです。 これにより、カスタム チャネルのユーザーは、 NetTcpBinding などのシステム提供のバインドや、 TcpTransportBindingElementを使用したカスタム バインドを構成する場合と同様に、.config ファイルを使用してチャネルを構成できます。

カスタム チャネルを記述し、新しい BindingElement または Bindingを使用してプログラミング モデルに公開する場合は、.config ファイルを使用して BindingElement または Binding 構成可能にするクラスのセットを作成する必要があります。 ConfigurationCodeGenerator ツールを使用して、これらのクラスを生成し、顧客のエクスペリエンスを向上させることができます。

ツールをビルドするには

1. ソリューションをビルドするには、「 Windows Communication Foundation サンプルのビルド」の手順に従います。

2. ソリューションをビルドすると、ConfigurationCodeGenerator.exeという 1 つのファイルが生成されます。 ファイル SampleRun.cmdには、このツールを使用して Transport: 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 用に 3 つの.cs ファイル (/be: オプションを指定した場合)、標準 Binding 用の 5 つの.cs ファイル (/sb: オプションを指定した場合)、および .xml ファイルを生成します。

   1. /be オプションを使用した場合、.cs ファイルの 1 つにバインド要素の BindingElementExtensionSection が実装されます。 このコードは、他のカスタム バインドでバインド要素を使用できるように、 BindingElement を構成システムに公開します。 他のファイルには、既定値と定数を表すクラスがあります。 ファイルには //TODO コメントがあり、既定値を更新するよう促します。

   2. /sb オプションを指定した場合、.cs ファイルの 2 つでそれぞれ StandardBindingElement と StandardBindingCollectionElement が実装され、構成システムに標準バインドが公開されます。 他のファイルには、既定値と定数を表すクラスがあります。 ファイルには //TODO コメントがあり、既定値を更新するよう促します。

      /sb: オプションを指定した場合、CodeToAddTo<YourStdBinding>.cs には、標準バインディングを実装するクラスに手動で追加する必要があるコードがあります。

   SampleConfig.xml ファイルには、前の手順 1 または 2 で定義したハンドラーを登録する構成ファイルに追加する必要がある構成コードが含まれています。