Sdílet prostřednictvím

ConfigurationCodeGenerator

  • Článek

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 konfigurovat váš kanál pomocí souboru .config stejně, jako by nakonfigurovali systémovou vazbu, jako NetTcpBinding je nebo vlastní vazba pomocí nástroje TcpTransportBindingElement.

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 tyto třídy vygenerovat a vylepšit prostředí zákazníka.

Sestavení nástroje

  1. Pokud chcete sestavit řešení, postupujte podle pokynů v části 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 .

Spuštění nástroje

  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 zveřejňuje BindingElement konfigurační systém, aby ostatní vlastní vazby mohly použít váš element 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 v uvedeném pořadí, které zpřístupňuje standardní vazbu konfiguračnímu systému. 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.