ConfigurationCodeGenerator

Der ConfigurationCodeGenerator ist ein Tool, mit dem Sie Ihre Implementierungen von benutzerdefinierten Kanälen für das Konfigurationssystem verfügbar machen können. Auf diese Weise können Benutzer den benutzerdefinierten Kanal wie bei vom System bereitgestellten Bindungen (wie NetTcpBinding) oder benutzerdefinierten Bindungen mit dem TcpTransportBindingElement mithilfe einer .config-Datei konfigurieren.

Wenn Sie einen benutzerdefinierten Kanal schreiben und ihn mit einem neuen BindingElement oder einer neuen Binding für das Programmiermodell verfügbar machen, müssen Sie eine Reihe von Klassen erstellen, damit das BindingElement bzw. die Binding mit einer .config-Datei konfiguriert werden kann. Mit dem Tool ConfigurationCodeGenerator können Sie diese Klassen generieren und Ihren Kunden die Arbeit erleichtern.

So erstellen Sie das Tool

1. Folgen Sie zum Erstellen der Lösung den unter Erstellen der Windows Communication Foundation-Beispiele aufgeführten Anweisungen.

2. Beim Erstellen der Projektmappe wird eine Datei generiert: ConfigurationCodeGenerator.exe. Die Datei "SampleRun.cmd" verfügt über eine Beispielbefehlszeile, die veranschaulicht, wie dieses Tool zum Generieren der Klassen für das Transport: UDP-Beispiel verwendet wird.

So führen Sie das Tool aus

1. Wenn Sie sowohl einen benutzerdefinierten BindingElement-Typ als auch einen benutzerdefinierten Binding-Typ haben, geben Sie an der Eingabeaufforderung Folgendes ein:

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

   Wenn Sie nur einen benutzerdefinierten BindingElement-Typ haben, geben Sie Folgendes ein:

   ConfigurationCodeGenerator.exe /be:YourCustomBindingElementTypeName /dll: TheAssemblyWhereThisTypeIsDefined
   

   Wenn Sie nur einen benutzerdefinierten Binding-Typ haben, geben Sie Folgendes ein:

   ConfigurationCodeGenerator.exe /sb:YourCustomStdBindingTypeName /dll:TheAssemblyWhereThisTypeIsDefined
   

   Der Befehl generiert drei .cs-Dateien für das BindingElement (wenn sie die Option "/be:" angegeben haben), fünf .cs-Dateien für die normale Binding (wenn Sie die Option "/sb:" angegeben haben), und eine .xml-Datei.

   1. Bei Verwendung der Option "/be" implementiert eine der .cs-Dateien den BindingElementExtensionSection für Ihr Bindungselement. Dieser Code macht Ihr BindingElement für das Konfigurationssystem verfügbar, sodass Ihr Bindungselement auch von anderen benutzerdefinierten Bindungen verwendet werden kann. Die anderen Dateien enthalten Klassen, die Standardwerte und Konstanten darstellen. Die Dateien enthalten //TODO-Kommentare, um Sie daran zu erinnern, die Standardwerte zu aktualisieren.
   2. Wenn Sie die Option "/sb" angegeben haben, implementieren zwei der .cs-Dateien ein StandardBindingElement bzw. ein StandardBindingCollectionElement, das Ihre Standardbindung für das Konfigurationssystem verfügbar macht. Die anderen Dateien enthalten Klassen, die Standardwerte und Konstanten darstellen. Die Dateien enthalten //TODO-Kommentare, um Sie daran zu erinnern, die Standardwerte zu aktualisieren.
      Wenn Sie die Option "/sb:" angegeben haben, enthält die Datei CodeToAddTo<YourStdBinding>.cs Code, den Sie manuell in die Klasse einfügen müssen, die Ihre Standardbindung implementiert.

   Die Datei "SampleConfig.xml" enthält den Konfigurationscode, den Sie der Konfigurationsdatei hinzufügen müssen, die die oben in Schritt 1 oder 2 definierten Handler registriert.

Send comments about this topic to Microsoft.
© 2007 Microsoft Corporation. All rights reserved.