GenerátorKonfiguračníhoKódu

ConfigurationCodeGenerator je nástroj, který můžete použít k zveřejnění vlastních implementací kanálů pro konfigurační systém. To umožňuje uživatelům vašeho vlastního kanálu nakonfigurovat kanál pomocí souboru .config, stejně jako by nakonfigurovali systémovou vazbu, například s použitím NetTcpBinding, nebo vlastní vazbu s použitím TcpTransportBindingElement nástroje.

Když napíšete vlastní kanál a zpřístupníte ho programovacímu modelu pomocí nového BindingElement nebo Binding, musíte vytvořit sadu tříd, aby byl BindingElement nebo Binding konfigurovatelný pomocí souboru .config. Pomocí nástroje ConfigurationCodeGenerator můžete vygenerovat tyto třídy a zlepšit zkušenost zákazníka.

Sestavení nástroje

1. Pro sestavení řešení postupujte podle pokynů v Sestavení ukázek Windows Communication Foundation.

2. Sestavení řešení vygeneruje jeden soubor: ConfigurationCodeGenerator.exe. Soubor SampleRun.cmd obsahuje ukázkový příkazový řádek, který ukazuje, jak pomocí tohoto nástroje vygenerovat třídy pro ukázku Transport: UDP .

Spustit nástroj

1. Na příkazovém řádku zadejte následující, pokud máte vlastní BindingElement typ i vlastní Binding typ:

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

   Pokud máte jenom vlastní BindingElement typ, zadejte následující:

   ConfigurationCodeGenerator.exe /be:YourCustomBindingElementTypeName /dll: TheAssemblyWhereThisTypeIsDefined
   

   Pokud máte jenom vlastní Binding typ, zadejte následující:

   ConfigurationCodeGenerator.exe /sb:YourCustomStdBindingTypeName /dll:TheAssemblyWhereThisTypeIsDefined
   

   Příkaz vygeneruje tři .cs soubory pro BindingElement (pokud jste zadali možnost /be:), pět .cs souborů pro standard Binding (pokud jste zadali možnost /sb:) a .xml soubor.

   1. Pokud jste použili možnost /be, jeden z .cs souborů implementuje prvek vazby BindingElementExtensionSection . Tento kód otevírá váš BindingElement konfiguračnímu systému, aby ostatní přizpůsobené vazby mohly použít váš prvek vazby. Ostatní soubory mají třídy, které představují výchozí hodnoty a konstanty. Soubory mají //TODO komentáře, které vám připomenou, abyste aktualizovali výchozí hodnoty.

   2. Pokud jste zadali možnost /sb, dva ze souborů .cs implementují StandardBindingElement a StandardBindingCollectionElement, což umožňuje standardní vazbu s konfiguračním systémem. Ostatní soubory mají třídy, které představují výchozí hodnoty a konstanty. Soubory mají //TODO komentáře, které vám připomenou, abyste aktualizovali výchozí hodnoty.

      Pokud jste zadali parametr /sb: CodeToAddTo<YourStdBinding>.cs má kód, který musíte ručně přidat do třídy, která implementuje standardní vazbu.

   Soubor SampleConfig.xml obsahuje konfigurační kód, který musíte přidat do konfiguračního souboru, který zaregistruje obslužné rutiny definované v předchozím kroku 1 nebo 2.