GeneratorKodówKonfiguracji

ConfigurationCodeGenerator to narzędzie, którego można użyć, aby udostępnić własne implementacje kanałów w systemie konfiguracji. Dzięki temu użytkownicy kanału niestandardowego mogą konfigurować kanał przy użyciu pliku .config, tak jak konfigurowaliby powiązanie dostarczone przez system, takie jak NetTcpBinding, lub powiązanie niestandardowe przy użyciu TcpTransportBindingElement.

Podczas pisania niestandardowego kanału i udostępniania go w modelu programowania przy użyciu nowego BindingElement lub Binding, należy utworzyć zestaw klas, aby BindingElement lub Binding były konfigurowalne przy użyciu pliku .config. Możesz użyć narzędzia ConfigurationCodeGenerator, aby wygenerować te klasy i ulepszyć doświadczenie klienta.

Aby skompilować narzędzie

1. Aby skompilować rozwiązanie, postępuj zgodnie z instrukcjami w temacie Building the Windows Communication Foundation Samples (Tworzenie przykładów programu Windows Communication Foundation).

2. Kompilowanie rozwiązania generuje jeden plik: ConfigurationCodeGenerator.exe. Plik SampleRun.cmd zawiera przykładowy wiersz polecenia, który pokazuje, jak używać tego narzędzia do generowania klas dla przykładu Transport: UDP .

Aby uruchomić narzędzie

1. W wierszu polecenia wpisz następujące polecenie, jeśli masz zarówno typ niestandardowy BindingElement , jak i typ niestandardowy Binding :

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

   Lub wpisz następujące, jeśli masz tylko niestandardowy typ BindingElement:

   ConfigurationCodeGenerator.exe /be:YourCustomBindingElementTypeName /dll: TheAssemblyWhereThisTypeIsDefined
   

   Lub wpisz następujące, jeśli masz tylko niestandardowy typ Binding:

   ConfigurationCodeGenerator.exe /sb:YourCustomStdBindingTypeName /dll:TheAssemblyWhereThisTypeIsDefined
   

   Polecenie generuje trzy pliki .cs dla BindingElement (jeśli określono /be: opcja), pięć .cs plików dla standardu Binding (jeśli określono /sb: opcja) i .xml pliku.

   1. Jeśli użyto opcji /be, jeden z plików .cs implementuje element BindingElementExtensionSection dla Twojego elementu powiązania. Ten kod udostępnia twój BindingElement dla systemu konfiguracji, aby inne powiązania niestandardowe mogły używać elementu powiązania. Inne pliki mają klasy reprezentujące wartości domyślne i stałe. Pliki mają //TODO komentarze, aby przypomnieć o zaktualizowaniu wartości domyślnych.

   2. Jeśli określono opcję /sb, dwa z plików .cs odpowiednio implementują StandardBindingElement i StandardBindingCollectionElement, co ujawnia standardowe powiązanie z systemem konfiguracji. Inne pliki mają klasy reprezentujące wartości domyślne i stałe. Pliki mają //TODO komentarze, aby przypomnieć o zaktualizowaniu wartości domyślnych.

      Jeśli określono opcję /sb:, CodeToAddTo<YourStdBinding>.cs zawiera kod, który należy ręcznie dodać do klasy implementującej powiązanie standardowe.

   Plik SampleConfig.xml zawiera kod konfiguracji, który należy dodać do pliku konfiguracji, który rejestruje programy obsługi zdefiniowane w poprzednim kroku 1 lub 2.