ConfigurationCodeGenerator

ConfigurationCodeGenerator is een hulpprogramma dat u kunt gebruiken om uw aangepaste kanaal-implementaties beschikbaar te maken voor het configuratiesysteem. Hierdoor kunnen gebruikers van uw aangepaste kanaal uw kanaal configureren met behulp van een .config-bestand, net zoals ze een door het systeem geleverde binding zoals NetTcpBinding of een aangepaste binding configureren met behulp van de TcpTransportBindingElement.

Wanneer u een aangepast kanaal schrijft en beschikbaar maakt voor het programmeermodel met behulp van een nieuw BindingElement of Binding, moet u een set klassen maken om het BindingElement of Binding configureerbaar te maken met behulp van een .config bestand. U kunt het hulpprogramma ConfigurationCodeGenerator gebruiken om deze klassen te genereren en de ervaring van uw klant te verbeteren.

Het hulpprogramma bouwen

1. Volg de instructies in Het bouwen van de Windows Communication Foundation-voorbeelden om de oplossing te bouwen.

2. Het bouwen van de oplossing genereert één bestand: ConfigurationCodeGenerator.exe. Het bestand SampleRun.cmd heeft een voorbeeldopdrachtregel die laat zien hoe u dit hulpprogramma kunt gebruiken om de klassen voor het UDP-voorbeeld te genereren.

Het hulpprogramma uitvoeren

1. Typ bij de opdrachtprompt het volgende als u zowel een aangepast BindingElement type als een aangepast Binding type hebt:

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

   Of typ het volgende als u alleen een aangepast BindingElement type hebt:

   ConfigurationCodeGenerator.exe /be:YourCustomBindingElementTypeName /dll: TheAssemblyWhereThisTypeIsDefined
   

   Of typ het volgende als u alleen een aangepast Binding type hebt:

   ConfigurationCodeGenerator.exe /sb:YourCustomStdBindingTypeName /dll:TheAssemblyWhereThisTypeIsDefined
   

   De opdracht genereert drie .cs bestanden voor de BindingElement (als u de optie /be hebt opgegeven), vijf .cs bestanden voor de standaard Binding (als u de optie /sb: hebt opgegeven) en een .xml bestand.

   1. Als u de optie /be hebt gebruikt, implementeert een van de .cs-bestanden het BindingElementExtensionSection voor uw bindingselement. Met deze code wordt uw BindingElement blootgesteld aan het configuratiesysteem, zodat andere aangepaste bindingen uw bindingselement kunnen gebruiken. De andere bestanden hebben klassen die standaardwaarden en constanten vertegenwoordigen. De bestanden bevatten //TODO opmerkingen om u eraan te herinneren dat u de standaardwaarden moet bijwerken.

   2. Als u de optie /sb hebt opgegeven, implementeren twee van de .cs-bestanden respectievelijk een StandardBindingElement en een StandardBindingCollectionElement , die uw standaardbinding beschikbaar maakt voor het configuratiesysteem. De andere bestanden hebben klassen die standaardwaarden en constanten vertegenwoordigen. De bestanden bevatten //TODO opmerkingen om u eraan te herinneren dat u de standaardwaarden moet bijwerken.

      Als u de /sb hebt opgegeven: de optie CodeToAddTo<YourStdBinding>.cs code bevat die u handmatig moet toevoegen aan de klasse waarmee uw standaardbinding wordt geïmplementeerd.

   Het bestand SampleConfig.xml bevat de configuratiecode die u moet toevoegen aan het configuratiebestand waarmee de handlers worden geregistreerd die zijn gedefinieerd in de vorige stap 1 of 2.