Configuration Editor-Tool (SvcConfigEditor.exe)Configuration Editor Tool (SvcConfigEditor.exe)

Der Service Configuration Editor (SvcConfigEditor.exe) der Windows Communication Foundation (WCF) ermöglicht Administratoren und Entwicklern, Konfigurationseinstellungen für WCF-Dienste anhand einer grafischen Benutzeroberfläche zu erstellen und zu bearbeiten.The Windows Communication Foundation (WCF) Service Configuration Editor (SvcConfigEditor.exe) allows administrators and developers to create and modify configuration settings for WCF services using a graphical user interface. Mit diesem Tool können Sie die Einstellungen für Bindungen, Verhalten, Dienste und Diagnosen von WCF verwalten, ohne XML-Dateien direkt bearbeiten zu müssen.With this tool, you can manage settings for WCF bindings, behaviors, services, and diagnostics without having to directly edit XML configuration files.

Der Service Configuration Editor befindet sich im Ordner "C:\Programme\Microsoft SDKs\Windows\v6.0\Bin".Service Configuration Editor can be found in the C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin folder.

Der WCF-Configuration EditorThe WCF Configuration Editor

Der Service Configuration Editor umfasst einen Assistenten, der Sie durch den Prozess der Konfiguration eines WCF-Diensts oder -Clients führt.Service Configuration Editor comes with a wizard that guides you through all the steps in configuring a WCF service or client. Es wird dringend geraten, den Assistenten und nicht den Editor zu verwenden.You are strongly advised to use the wizard instead of the editor directly.

Wenn Sie bereits über Konfigurationsdateien verfügen, die mit dem standardmäßigen System.Configuration-Schema konform sind, können Sie spezielle Einstellungen für Bindungen, Verhaltensweisen, Dienste und Diagnosen anhand der Benutzeroberfläche verwalten.If you already have some configuration files that comply with the standard System.Configuration schema, you can manage specific settings for bindings, behavior, services, and diagnostics with the user interface. Mit dem Service Configuration Editor können Sie die Einstellungen von vorhandenen WCF-Konfigurationsdateien sowie von ausführbaren Dateien, COM+-Diensten und im Internet gehosteten Diensten verwalten.The Service Configuration Editor enables you to manage the settings for existing WCF configuration files as well as executable files, COM+ services, and Web-hosted services. Beim Öffnen eines im Internet gehosteten Diensts mit dem Service Configuration Editor werden sowohl die eigene Konfiguration des Diensts sowie die von Knoten der oberen Ebene übernommenen Konfigurationsabschnitte angezeigt.When opening a Web-hosted service with Service Configuration Editor, both the service’s own configuration and inherited configurations sections of upper level nodes are shown.

Da sich die WCF-Konfigurationseinstellungen im <system.serviceModel>-Abschnitt der Konfigurationsdatei befinden, arbeitet der Editor nur mit dem Inhalt dieses Elements und greift auf keine anderen Elemente in dieser Datei zu.Because WCF configuration settings are located in the <system.serviceModel> section of the configuration file, the editor operates exclusively on the content of this element and does not access other elements in the same file. Sie können direkt zu vorhandenen Konfigurationsdateien wechseln, oder Sie können eine Assembly auswählen, die einen Dienst, ein virtuelles Verzeichnis oder einen COM+-Dienst enthält.You can navigate to existing configuration files directly or you can select an assembly that contains a service, virtual directory, or COM+ service. Der Editor lädt die Konfigurationsdatei für diesen Dienst und ermöglicht dem Benutzer, neue Elemente hinzuzufügen oder vorhandene Elemente des <system.serviceModel>-Abschnitts der Konfigurationsdatei zu bearbeiten.The editor loads the configuration file for that particular service and allows the user to either add new elements or edit existing elements nested in the <system.serviceModel> section of the configuration file.

Der Editor unterstützt IntelliSense und erzwingt Schemakompatibilität.The editor supports IntelliSense and enforces schema compliance. Die Ausgabe entspricht garantiert dem Schema der Konfigurationsdatei und weist syntaktisch korrekte Datenwerte auf.The resulting output is guaranteed to comply with the schema of the configuration file and to have syntactically correct data values. Der Editor garantiert jedoch nicht, dass die Konfigurationsdatei semantisch gültig ist.However, the editor does not guarantee that the configuration file is semantically valid. Mit anderen Worten: Der Editor garantiert nicht, dass die Konfigurationsdatei mit dem Dienst zusammenarbeiten kann, den sie konfiguriert.In other words, the editor does not guarantee that the configuration file can work with the service it configures.

Achtung

Der Editor kann kein Konfigurationselement aus der Konfigurationsdatei löschen, sobald das Element geändert wurde.The editor cannot purge a configuration element from the configuration file once you have modified the element. Wenn Sie beispielsweise den Editor verwendet haben, um den Endpunktnamen auf eine nicht leere Zeichenfolge festzulegen, und diesen speichern, weist die Konfigurationsdatei folgenden Inhalt auf, wie im folgenden Beispiel gezeigt:For example, if you use the editor to set the endpoint name to a non-empty string and save it, the configuration file has the following content, as shown in the following example.

<endpoint binding="basicHttpBinding" name="somename" />

Wenn Sie versuchen, den Namen zu entfernen, indem Sie eine leere Zeichenfolge festlegen, und die Datei speichern, enthält die Konfigurationsdatei weiterhin das name-Attribut, wie im folgenden Beispiel gezeigt:If you attempt to remove the name by setting it to an empty string and save the file, the configuration file still contains the name attribute, as shown in the following example.

<endpoint binding="basicHttpBinding" name="" />

Um das Attribut zu löschen, müssen Sie das Element manuell mit einem anderen Text-Editor bearbeiten.To purge the attribute, you must manually edit the element using another text editor.

Sie sollten besonders vorsichtig vorgehen, wenn Sie das issueToken-Element des clientCredential-Endpunktverhaltens verwenden.You should be especially careful with this issue when you use the issueToken element of the clientCredential Endpoint behavior. Vor allem das address-Attribut des localIssuer-Unterelements darf keine leere Zeichenfolge sein.Specifically, the address attribute of its localIssuer sub-element must not be an empty string. Wenn Sie das address-Attribut mit dem Configuration Editor geändert haben und es vollständig entfernen möchten, sollten Sie dies mit einem anderen Tool als dem Editor durchführen.If you have modified the address attribute using the Configuration Editor and want to remove it completely, you should do so using a tool other than the Editor. Andernfalls enthält das Attribut eine leere Zeichenfolge, und die Anwendung löst eine Ausnahme aus.Otherwise, the attribute contains an empty string and your application throws an exception.

Verwenden von Configuration EditorUsing the Configuration Editor

Der Service Configuration Editor befindet sich in folgendem Windows SDK-Installationspfad:The Service Configuration Editor can be found at the following Windows SDK installation location:

C:\Programme\Microsoft SDKs\Windows\v6.0\Bin\SvcConfigEditor.exeC:\Program Files\Microsoft SDKs\Windows\v6.0\Bin\SvcConfigEditor.exe

Nachdem Sie den Dienstkonfigurations-Editor starten, können Sie mithilfe der Datei/öffnen Menü zu durchsuchen, die für den Dienst oder die Assembly, die Sie verwalten möchten.After you launch the Service Configuration Editor, you can use the File/Open menu to browse for the service or assembly you want to manage. Sie können Konfigurationsdateien direkt öffnen, nach WCF-/COM+-Diensten suchen und Konfigurationsdateien für über das Web gehostete Dienste öffnen.You can open configuration files directly, browse for WCF /COM+ services, and open configuration files for Web-hosted services.

Die Service Configuration Editor-Benutzeroberfläche ist in die folgenden Bereiche aufgeteilt:The Service Configuration Editor's user interface is divided into the following areas:

  • Strukturansichtsbereich, in dem die Konfigurationselemente links in einer Struktur angezeigt werden.Tree View Pane, which displays configuration elements in a tree structure on the left. Sie können in der Struktur Vorgänge durchführen, indem Sie mit der rechten Maustaste auf die Knoten klicken.You can perform operations in the tree by right-clicking the nodes.

  • Aufgabenbereich, der häufige Aufgaben für aktuelle Elemente links unten im Fenster anzeigt.Task Pane, which displays common tasks for current elements on the lower-left of the window

  • Detailbereich, in dem ausführliche Einstellungen des rechts in der Strukturansicht ausgewählten Konfigurationsknotens angezeigt werden.Detail Pane, which displays detailed settings of the configuration node selected in the Tree View on the right.

Öffnen einer KonfigurationsdateiOpening a Configuration File

  1. Starten Sie ein Befehlsfenster, das auf den WCF-Installationspfad navigieren, und geben Sie dann mit Dienstkonfigurations-Editor SvcConfigEditor.exe.Start Service Configuration Editor by using a command window to navigate to your WCF installation location, and then type SvcConfigEditor.exe.

  2. Aus der Datei klicken Sie im Menü öffnen , und klicken Sie auf den Typ der Datei, die Sie verwalten möchten.From the File menu, select Open and click the type of file you want to manage.

  3. In der öffnen Dialogfeld navigieren Sie zu der Datei zu verwalten, und doppelklicken darauf.In the Open dialog box, navigate to the specific file you want to manage and double-click it.

Der Viewer folgt dem Pfad für den Konfigurationsmerge automatisch und erstellt eine Ansicht der zusammengeführten Konfiguration.The viewer automatically follows the configuration merge path and creates a view of the merged configuration. So ist zum Beispiel die tatsächliche Konfiguration eines nicht gehosteten Diensts eine Kombination von Machine.config und App.config. Änderungen werden für die aktive Datei in SvcConfigEditor übernommen.For example, the actual configuration of a non-hosted service is a combination of Machine.config and App.config. Any changes are applied to the active file in the SvcConfigEditor. Wenn Sie eine bestimmte Datei im Pfad für die Konfigurationszusammenführung bearbeiten möchten, öffnen Sie diese Datei direkt.If you want to edit a specific file in the configuration merge path, you should open it directly.

Hinweis

Configuration Editor lädt die gerade geöffnete Konfigurationsdatei erneut, wenn sie außerhalb des Editors geändert wurde.Configuration Editor reloads the currently opened configuration file when the latter has been modified outside the Editor. Wenn dies geschieht, gehen alle Änderungen verloren, die nicht dauerhaft im Editor gespeichert wurden.When this happens, all the changes that are not durably saved inside the Editor are lost. Wenn das erneute Laden häufig auftritt, liegt dies meist an einem Dienst, der kontinuierlich auf die Konfigurationsdatei zugreift, z. B. eine im Hintergrund ausgeführte Antivirensoftware.If reloading happens consistently, the most likely cause is a service that constantly accesses the configuration file, for example, an antivirus software running in the background. Um dies zu beheben, müssen Sie sicherstellen, dass Configuration Editor der einzige Prozess ist, der auf die Datei zugreifen kann, wenn sie geöffnet ist.To resolve this, ensure that Configuration Editor is the only process that can access the file when it is opened.

DiensteServices

Die Services Knoten zeigt alle Dienste, die derzeit in der Konfigurationsdatei zugewiesen.The Services node displays all of the services currently assigned in the configuration file. Jeder untergeordnete Knoten in der Struktur entspricht ein Unterelement eines der <services>-Element in der Konfigurationsdatei.Each sub-node in the tree corresponds to a sub-element of the <services> element in the configuration file.

Beim Klicken auf die Services Knoten, die Sie anzeigen oder ausführen können Aufgaben auf dem Dienst Zusammenfassung auf der Seite der Detail Bereich.When you click the Services node, you can view or perform tasks on the service Summary Page in the Detail Pane.

Erstellen einer neuen DienstkonfigurationCreating a new Service Configuration

Sie können eine neue Dienstkonfiguration auf folgende Weise erstellen:You can create a new service configuration in the following ways:

  • Mithilfe eines Assistenten: Klicken Sie auf den Link einen neuen Dienst erstellen...Using a Wizard: Click the link Create a New Service… auf im Aufgabenbereich oder auf Seite "Zusammenfassung" um den Assistenten zu starten.on the Task Pane or Summary Page to launch the wizard. Sie können auch dazu die Datei -> neues Element hinzufügen.You can also do so in the File menu -> Add New Item.

  • Manuelles Erstellen: Sie können mit der rechten Maustaste die Services Knoten, und wählen Sie neuer Dienst.Create manually: You can right-click the Services node and choose New Service.

Erstellen einer neuen Dienstendpunkt-KonfigurationCreating a new Service Endpoint Configuration

Sie können eine neue Dienstendpunkt-Konfiguration auf folgende Weise erstellen:You can create a new service endpoint configuration in the following ways:

  • Erstellen mit dem Assistenten: Klicken Sie auf den Link neuen Dienstendpunkt erstellen...Create using a Wizard: click the link Create a New Service Endpoint… auf im Aufgabenbereich oder auf Seite "Zusammenfassung" um den Assistenten zu starten.on the Task Pane or Summary Page to launch the wizard. Sie können auch dazu die Datei -> neues Element hinzufügen.You can also do so in the File menu -> Add New Item.

  • Manuelles Erstellen: Nachdem Sie einen Dienst erstellt, Sie können mit der rechten Maustaste die Endpunkte Knoten, und wählen Sie "neuen Dienstendpunkt".Create manually: Once you created a Service, you can right-click the Endpoints node and choose "New Service Endpoint".

Bearbeiten einer DienstkonfigurationEditing a Service Configuration

  1. Klicken Sie auf eine Service Knoten.Click a Service node.

  2. Bearbeiten Sie die Einstellungen in den Eigenschaftenrastern.Edit the settings in the property grids.

Bearbeiten einer Dienstendpunkt-KonfigurationEditing a Service Endpoint Configuration

  1. Klicken Sie auf eine Dienstendpunkt Knoten.Click a Service Endpoint node.

  2. Bearbeiten Sie die Einstellungen in den Eigenschaftenrastern.Edit the settings in the property grids.

Hinzufügen einer BasisadresseAdding a Base Address

  1. Klicken Sie auf die Host Knoten.Click the Host node.

  2. Klicken Sie auf die neu...Click the New… die Schaltfläche in der Basisadressen Abschnitt.button in the Base Addresses section.

  3. Geben Sie den Basisadressen-URI im Dialogfeld ein.Type in the base address URI in the dialog box.

  4. Klicken Sie auf OK.Click OK.

Hinweis

Sie können nicht den Wert der Bearbeiten <BaseAddressPrefixFilters > innerhalb dieses Tool.You cannot edit the value of <baseAddressPrefixFilters> inside this tool. Um dieses Element hinzuzufügen oder zu ändern, sollten Sie einen Text-Editor oder Visual Studio verwenden.To add or modify this element, you should use a text editor or Visual Studio.

ClientClient

Die Client -Knoten zeigt alle Clientendpunkte in der Konfigurationsdatei.The Client node displays all of the client endpoints in the configuration file. Alle untergeordneten Knoten in der Struktur entspricht ein Unterelement eines der <client>-Element in der Konfigurationsdatei.Every sub-node in the tree corresponds to a sub-element of the <client> element in the configuration file.

Beim Klicken auf die Client Knoten können Sie anzeigen oder Ausführen von Aufgaben auf dem Client Seite "Zusammenfassung" in der Detailbereich.When you click the Client node, you can view or perform tasks on the client Summary Page in the Detail Pane.

Erstellen einer neuen Clientendpunkt-KonfigurationCreating a new Client Endpoint Configuration

Sie können eine neue Clientendpunkt-Konfiguration auf folgende Weise erstellen:You can create a new client endpoint configuration in the following ways:

  • Erstellen mit dem Assistenten: Klicken Sie auf den Link einen neuen Client erstellen...Create by Wizard: Click the link Create a New Client… auf der Aufgabenbereich auf der unteren linken Ecke des Fensters, oder Seite "Zusammenfassung" um den Assistenten zu starten.on the Task Pane on the lower-left of the window, or Summary Page to launch the wizard. Sie können auch dazu die Datei -> neues Element hinzufügen.You can also do so in the File menu -> Add New Item. Der Assistent fordert Sie auf, auf den Speicherort der Dienstkonfiguration zu zeigen, über den die Clientkonfiguration generiert wird.The wizard prompts you to point to the location of the service configuration, from which the client configuration is generated. Sie können dann den Dienstendpunkt auswählen, mit dem eine Verbindung hergestellt werden soll.You can then choose the service endpoint to connect to.

  • Manuelles Erstellen: mit der rechten Maustaste die Endpunkte Knoten unter Client, und wählen Sie neuer Clientendpunkt.Create manually: Right-click the Endpoints node under Client, and choose New Client Endpoint.

Bearbeiten einer Clientendpunkt-KonfigurationEditing a Client Endpoint Configuration

  1. Klicken Sie auf eine Clientendpunkt Knoten.Click a Client Endpoint node.

  2. Bearbeiten Sie die Einstellungen in den Eigenschaftenrastern.Edit the settings in the property grids.

StandardendpunktStandard Endpoint

Standardendpunkte sind spezialisierte Endpunkte, bei denen einer oder mehrere Aspekte der Adresse, des Vertrags und des Bindungssatzes auf die Standardwerte festgelegt sind.Standard endpoints are specialized endpoints that have one or more aspects of the address, contract and binding set to default values.

Diese Konfigurationseinstellungen werden gespeichert, der Standardendpunkt Knoten.Such configuration settings are stored in the Standard Endpoint node. Die Standardendpunkt -Knoten zeigt alle standardendpunkteinstellungen in der Konfigurationsdatei.The Standard Endpoint node displays all of the standard endpoint settings in the configuration file. Alle untergeordneten Knoten in der Struktur entspricht ein untergeordnetes Element in der <standardEndpoints> Element in der Konfigurationsdatei.Every sub-node in the tree corresponds to a sub-element in the <standardEndpoints> element in the configuration file.

Beim Klicken auf die Standardendpunkt Knoten können Sie anzeigen oder Ausführen von Aufgaben auf den Standardendpunkt Seite "Zusammenfassung" in der Detailbereich.When you click the Standard Endpoint node, you can view or perform tasks on the standard endpoint Summary Page in the Detail Pane.

Erstellen einer neuen StandardendpunktkonfigurationCreating a New Standard Endpoint Configuration

Sie können eine neue Standardendpunktkonfiguration auf folgende Weise erstellen:You can create a new standard endpoint configuration in the following ways:

  • Mit der rechten Maustaste die Standardendpunkt Knoten, und wählen neue Konfiguration des Standardendpunkts...Right-click the Standard Endpoint node and select New Standard Endpoint Configuration… Wählen Sie den Bindungstyp im Dialogfeld, und klicken Sie auf OK.Select the binding type in the dialog box and click OK.

  • Wählen Sie die Standardendpunkt Knoten, und klicken Sie auf neue Konfiguration des Standardendpunkts...Select the Standard Endpoint node and click New Standard Endpoint Configuration… in der Aufgabenbereich auf der unteren linken Ecke des Fensters.in the Task Pane on the lower-left of the window.

Die erstellen einen neuen Standardendpunkt Dialogfeld zeigt an, und alle registrierten standardendpunkttypen aufgeführt.The Creating a New Standard Endpoint dialog box displays and lists all registered standard endpoint types.

Anzeigen und Bearbeiten einer StandardendpunktkonfigurationViewing and Editing a Standard Endpoint Configuration

Sie können eine Standardendpunktkonfiguration auf die folgende Weise zum Anzeigen und Bearbeiten öffnen:You can open a standard endpoint configuration for viewing and editing in the following ways:

  • Klicken Sie zum Erweitern der Standardendpunkt Knoten, und klicken Sie auf den jeweiligen untergeordneten Endpunktknoten.Click to expand the Standard Endpoint node and click the respective endpoint sub-node.

  • Klicken Sie auf die Standardendpunkt Knoten, und klicken Sie auf den jeweiligen Endpunkt im Detailbereich.Click the Standard Endpoint node and click the respective endpoint on the Detail pane.

Attribute für den Endpunkt werden zur Bearbeitung im rechten Bereich angezeigt.Attributes for the endpoint are shown in the right pane for editing.

Löschen einer StandardendpunktkonfigurationDeleting a Standard Endpoint Configuration

Sie können eine Standardendpunktkonfiguration auf folgende Weise löschen:You can delete a standard endpoint configuration in the following ways:

  • Klicken Sie zum Erweitern der Standardendpunkt Knoten und mit der rechten Maustaste den jeweiligen untergeordneten Endpunktknoten.Click to expand the Standard Endpoint node and right-click the respective endpoint sub-node. Verwenden Sie den Kontextbefehl Konfiguration des Standardendpunkts löschen beim Löschen des Endpunkts.Use the context command Delete Standard Endpoint Configuration to delete the endpoint.

  • Klicken Sie auf die Standardendpunkt Knoten.Click the Standard Endpoint node. In der Aufgabe Bereich, klicken Sie auf Konfiguration des Standardendpunkts löschen.In the Task pane, click Delete Standard Endpoint Configuration.

Wenn der Standardendpunkt verwendet wird, wird beim Versuch, ihn zu löschen, eine Warnmeldung angezeigt: Der Standardendpunkt wird verwendet. Wenn er jetzt gelöscht wird, müssen Sie sicherstellen, dass alle dazugehörigen Verweise an anderen Stellen der Konfiguration (z. B. im Dienstendpunkt oder Clientendpunkt) ebenfalls gelöscht werden. Andernfalls ist die Konfiguration ungültig und kann nächstes Mal nicht geöffnet werden. Sind Sie sicher, dass Sie den Standardendpunkt löschen möchten? "If the standard endpoint is in used, a warning message is displayed when you attempt to delete it: The standard endpoint is in use. If you delete it now, please be sure to delete all of its references in other parts of the configuration (for example, in the service endpoint or client endpoint). Otherwise, the configuration will be invalid and cannot be opened next time. Are you sure you want to delete the standard endpoint?"

BindungBinding

Bindungskonfigurationen werden zum Konfigurieren von Bindungen auf Endpunkten verwendet.Binding configurations are used to configure bindings on endpoints. Diese Konfigurationseinstellungen werden gespeichert, der binden Knoten.Such configuration settings are stored in the Binding node. Endpunkte verweisen anhand des Namens auf Bindungskonfigurationen, und mehrere Endpunkte können auf eine einzelne Bindungskonfiguration verweisen.Endpoints reference binding configurations by name and multiple endpoints can reference a single binding configuration.

Die Bindungen -Knoten zeigt alle bindungseinstellungen in der Konfigurationsdatei.The Bindings node displays all of the binding settings in the configuration file. Alle untergeordneten Knoten in der Struktur entspricht ein untergeordnetes Element in der <bindings>-Element in der Konfigurationsdatei.Every sub-node in the tree corresponds to a sub-element in the <bindings> element in the configuration file.

Beim Klicken auf die Bindungen Knoten können Sie anzeigen oder Ausführen von Aufgaben für die Bindung Seite "Zusammenfassung" in der Detailbereich.When you click the Bindings node, you can view or perform tasks on the binding Summary Page in the Detail Pane.

Erstellen einer neuen BindungskonfigurationCreating a New Binding Configuration

Sie können eine neue Bindungskonfiguration auf folgende Weise erstellen:You can create a new binding configuration in the following ways.

  • Mit der rechten Maustaste die Bindungen Knoten, und wählen neue Bindungskonfiguration...Right-click the Bindings node and select New Binding Configuration Wählen Sie den Bindungstyp im Dialogfeld, und klicken Sie auf OK.Select the binding type in the dialog box and click OK.

  • Wählen Sie die Bindungen Knoten, und klicken Sie auf neue Bindungskonfiguration...Select the Bindings node and click New Binding Configuration in der Aufgabenbereich auf der unteren linken Ecke des Fensters.in the Task Pane on the lower-left of the window.

  • Klicken Sie in der Dienst- oder Clientanwendung Seite "Zusammenfassung", auf klicken Sie auf Erstellen in der Bindungskonfiguration Feld, um eine Bindungskonfiguration für den entsprechenden Endpunkt zu erstellen.In the service or client summary page, click Click to Create in the Binding Configuration field to create a binding configuration for the corresponding endpoint.

Hinzufügen von Bindungselementerweiterungen zu einer benutzerdefinierten BindungAdding Binding Element Extensions to a Custom Binding

  1. Wählen Sie die Bindung aus, der Sie ein Erweiterungselement hinzufügen möchten.Select the binding you want to add an extension element to.

  2. Klicken Sie auf Hinzufügen.Click Add.

  3. Wählen Sie aus der Liste der verfügbaren Erweiterungen die Bindungselementerweiterung aus, die Sie hinzufügen möchten.From the list of available extensions, select the binding element extension you want to add. Sie können mehrere Elemente auswählen, indem Sie die STRG-TASTE gedrückt halten.To select multiple items, press the CTRL key simultaneously.

  4. Klicken Sie auf Hinzufügen.Click Add.

Anpassen der Erweiterungsposition in einer benutzerdefinierten BindungAdjusting the Extension Position in a Custom Binding

Eine benutzerdefinierte Bindung ist eine Auflistung von Bindungselementen, die einen Stapel bilden.A custom binding is a collection of binding elements that form a stack. Jedes Bindungselement auf dem Stapel verfügt über eigene Konfigurationseinstellungen.Each binding element on the stack has its own configuration settings. Die Reihenfolge der Bindungselementerweiterungen in einer benutzerdefinierten Bindung gibt ihre Positionen im Stapel an.The order of the binding element extensions in a custom binding indicates their positions in the stack. Elemente oben im Stapel werden zuerst übernommen.Elements at the top of the stack are applied first. So ändern Sie die ReihenfolgeTo change the ordering:

  1. Wählen Sie den benutzerdefinierten Bindungsknoten aus.Select the custom binding node.

  2. Wählen Sie ein bindungserweiterungselement in der Bindungselementerweiterungs-Position Abschnitt.Select one binding extension element in the Binding Element Extension Position section.

  3. Verwenden der einrichten oder unten Schaltfläche auf der linken Seite der Liste, um die Position des ausgewählten Elements zu ändern.Use the Up or Down button on the left side of the list to change the position of the selected element.

Bearbeiten der Bindungselementerweiterungs-Konfiguration in einer benutzerdefinierten BindungEditing the Configuration of Binding Element Extensions in a Custom Binding

  1. Wählen Sie den Bindungsknoten in der Struktur aus.Select the binding node in the tree.

  2. Wählen Sie die benutzerdefinierte Bindung, die das zu bearbeitende Element enthält.Select the custom binding that contains the element you want to edit.

  3. Wählen Sie die Bindungselementerweiterung aus, die Sie bearbeiten möchten.Select the binding element extension you want to edit. Die Einstellungen des Elements werden im rechten Bereich angezeigt, in dem sie bearbeitet werden können.The settings of the element appear in the right pane, where they can be edited.

DiagnoseDiagnostics

Die Diagnose -Knoten zeigt alle diagnoseeinstellungen in der Konfigurationsdatei.The Diagnostics node displays all of the diagnostic settings in the configuration file. Sie können Sie aktivieren oder deaktivieren Sie die Leistungsindikatoren, aktivieren oder Deaktivieren von Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI), Konfigurieren von WCF-Ablaufverfolgung und WCF-nachrichtenprotokollierung konfigurieren.It enables you to turn performance counters on or off, enable or disable Windows Management Instrumentation (WMI), configure WCF tracing, and configure WCF message logging. Die Einstellungen in der Diagnose Knoten entsprechen den <system.diagnostics> Abschnitt und <diagnostics> im Abschnitt <system.serviceModel> in der Konfigurationsdatei.The settings in the Diagnostics node correspond to the <system.diagnostics> section, and <diagnostics> section in <system.serviceModel> in the configuration file.

Beim Klicken auf die Diagnose Knoten können Sie anzeigen oder Ausführen von Aufgaben auf die Diagnose Seite "Zusammenfassung" in der Detailbereich.When you click the Diagnostics node, you can view or perform tasks on the diagnostics Summary Page in the Detail Pane.

Konfigurieren von Leistungsindikatoren und WMIConfiguring performance counters and WMI

  1. Klicken Sie auf die Diagnose Knoten.Click the Diagnostics node.

  2. Klicken Sie auf umschalten Leistungsindikatoren.Click Toggle Performance Counters. Der Leistungsindikator verfügt über drei Zustände: Aus (Standard), ServiceOnly und Alles.The performance counter has three states: Off (default), ServiceOnly, and All. Wenn Sie auf den Link klicken, wird diese Einstellung auf einen der drei Zustände festgelegt.Clicking the link toggles the setting among these three states.

Konfigurieren eines WMI-AnbietersConfiguring WMI Provider

  1. Klicken Sie auf die Diagnose Knoten.Click the Diagnostics node.

  2. Um WMI-Anbieter zu aktivieren, klicken Sie auf die WMI-Anbieter aktivieren Link.To enable WMI provider, click the Enable WMI Provider link.

Aktivieren von WCF-AblaufverfolgungEnabling WCF Tracing

Sie können eine WCF-Ablaufverfolgungsdatei mit Standardeigenschaften erstellen oder eine benutzerdefinierte Ablaufverfolgungsdatei einrichten.You can create a WCF trace file with standard properties or set up a custom trace file.

  1. Klicken Sie auf die Diagnose Knoten.Click the Diagnostics node.

  2. Klicken Sie auf Aktivieren der Ablaufverfolgung.Click Enable Tracing.

  3. Klicken Sie auf die Ablaufverfolgungsebene Link, um die Ablaufverfolgungsebene einzustellen.Click the Trace Level link to adjust the trace level. Es gibt sechs Ablaufverfolgungsebenen: Off, Critical, Error, Warning, Information und Verbose.There are six trace levels: Off, Critical, Error, Warning, Information, and Verbose. Die Aktivitätsablaufverfolgung und Aktivität propagieren Option ermöglichen es Ihnen, die WCF aktivitätsablaufverfolgungs-Feature zu verwenden.The Activity Tracing and Propagate Activity option enable you to use the WCF activity tracing feature.

  4. Klicken Sie auf den Namen des Ablaufverfolgungslisteners, um die Ablaufverfolgungsdatei und die Optionen festzulegen.Click the trace listener name to specify the trace file and options.

Aktivieren der WCF-ProtokollierungEnabling WCF Logging

Sie können eine WCF-Ablaufverfolgungsdatei mit Standardeigenschaften erstellen oder eine benutzerdefinierte Ablaufverfolgungsdatei einrichten.You can create a WCF trace file with standard properties or set up a custom trace file.

  1. Klicken Sie auf die Diagnose Knoten.Click the Diagnostics node.

  2. Klicken Sie auf Nachrichtenprotokollierung aktivieren.Click Enable Message Logging.

  3. Klicken Sie auf die Protokollebene Link, um die Protokollebene einzustellen.Click the Log Level link to adjust the log level. Es gibt drei Protokollebenen: Fehlerhaft, Dienst und Transport.There are three log levels: Malformed, Service, and Transport.

  4. Klicken Sie auf den Namen des Listeners, um die Protokolldatei und die Optionen festzulegen.Click the listener name to specify the log file and options.

Hinweis

Wenn Sie möchten die Ablaufverfolgungs- und Nachrichtenprotokollen automatisch geleert werden, wenn die Anwendung geschlossen wird, aktivieren Sie die automatische Leerung Option.If you want the trace and message logs to be flushed automatically when your application is closed, enable the Auto Flush option.

Die Diagnose Seite "Zusammenfassung" ermöglicht Ihnen die Durchführung der häufigsten Aufgaben bei der Diagnosekonfiguration.The Diagnostics Summary Page enables you to accomplish the most common tasks in configuring diagnostics. Jedoch, wenn Sie die Listener- und Einstellungen manuell bearbeiten möchten, erweitern Sie die Diagnose Knoten und Bearbeiten von Einstellungen in Nachrichtenprotokollierung, Listener und Quellen Knoten.However, if you want to manually edit the Listeners and Sources settings, you must expand the Diagnostics node and edit settings in Message Logging, Listeners and Sources node.

Aktivieren von benutzerdefinierter WCF-Ablaufverfolgung oder NachrichtenprotokollierungEnabling WCF Custom Tracing or Message Logging

  1. Klicken Sie auf die Diagnose Knoten, und erweitern Sie ihn.Click the Diagnostics node, and expand it.

  2. Mit der rechten Maustaste die Listener Knoten, und wählen neuer Listener.Right-click the Listeners node and select New Listener.

  3. Geben Sie den Namen der Ablaufverfolgungsdatei in der InitData Feld.Type in the trace file name in the InitData field. Sie können die Schaltfläche "...", um einen Pfad zu suchen, klicken.You can click the "…" button to browse to a path.

  4. Klicken auf die TypeName Zeile wird eine Schaltfläche "..." angezeigt.Clicking the TypeName line displays a "…" button. Klicken Sie auf diese Schaltfläche, um das Öffnen der Ablaufverfolgungslistener-Typbrowser, die Sie verwenden können, um vorkonfigurierte Ablaufverfolgungslistener suchen, die bereits installiert sind.Click this button to open the Trace Listener Type Browser, which you can use to find pre-configured trace listeners that are already installed.

  5. Beachten Sie die Quelle Abschnitt.Note the Source section. Klicken Sie auf hinzufügen in diesem Abschnitt, um ein Dialogfeld mit einem Dropdownmenü zu öffnen, die verfügbaren Ablaufverfolgungsquellen aufgeführt sind.Click Add in this section to open a dialog box with a drop-down menu, which lists available tracing sources. Wählen Sie eine Ablaufverfolgungsquelle aus, und klicken Sie auf OK.Select a tracing source and click OK.

  6. Um Einstellungen für die Nachrichtenprotokollierung zu bearbeiten, klicken Sie auf die Nachrichtenprotokollierung Knoten.To edit Message Logging settings, click the Message Logging node. Sie können die Einstellungen im Eigenschaftenraster bearbeiten.You can edit the settings in the property grid.

ErweitertAdvanced

VerhaltenBehaviors

Die Verhalten Knoten zeigt an, die Verhaltensweisen, die derzeit in der Konfigurationsdatei definiert sind.The Behaviors node displays the behaviors that are currently defined in the configuration file.

Verhaltenskonfigurationen werden verwendet, um Verhalten von Endpunkten und Diensten zu konfigurieren.Behavior configurations are used to configure behaviors of endpoints and services. Diese Konfigurationseinstellungen werden gespeichert, der erweitert Knoten unter Dienstverhalten und Endpunktverhalten.Such configuration settings are stored in the Advanced node under Service Behaviors and Endpoint Behaviors. Dienstverhalten werden von Diensten verwendet, Endpunktverhalten dagegen von Endpunkten.Service behaviors are used by services; whereas endpoint behaviors by endpoints.

Verhalten sind eine Auflistung von Erweiterungselementen für einen Stapel.Behaviors are a collection of extension elements that for a stack. Das Element oben im Stapel wird zuerst übernommen.The element at the top of the stack is applied first. Jedes Erweiterungselement kann über eine eigene Konfiguration verfügen.Each extension element can have its own configuration.

Erstellen einer neuen VerhaltenskonfigurationCreating a new Behavior Configuration

Sie können eine neue Verhaltenskonfiguration auf eine der folgenden Weisen erstellen:You can create a new behavior configuration in two ways.

  • Mit der rechten Maustaste einen der verhaltensknoten aus, und wählen Sie "neue VerhaltenskonfigurationRight-click one of the behavior nodes and select "New Behavior Configuration…

  • Wählen Sie einen der verhaltensknoten aus, und klicken Sie auf die neue Verhaltenskonfiguration...Select one of the behavior nodes and click the New Behavior Configuration in der Aufgabenbereich auf der unteren linken Ecke des Fensters.in the Task Pane on the lower-left of the window.

Hinzufügen von Verhaltenselementerweiterungen zu einem VerhaltenAdding Behavior Element Extensions to a Behavior
  1. Wählen Sie einen der Verhaltensknoten aus.Select one of the behavior nodes.

  2. Markieren Sie das zu bearbeitende Verhalten.Select the behavior you want edit.

  3. Klicken Sie auf Hinzufügen.Click Add.

  4. Wählen Sie aus der Liste der verfügbaren Erweiterungen die Verhaltenselementerweiterung aus, die Sie hinzufügen möchten.From the list of available extensions, select the behavior element extension you want to add.

  5. Klicken Sie auf Hinzufügen.Click Add.

Anpassen der Erweiterungsposition in einem VerhaltenAdjusting the Extension Position in a Behavior

Verhalten sind Auflistungen von Elementen, die einen Stapel bilden.Behaviors are collections of elements that form a stack. Jedes Element im Stapel verfügt über seine eigene Konfiguration.Each element on the stack has its own configuration. Die Reihenfolge der Verhaltenselementerweiterungen in einem Verhalten gibt ihre Positionen im Stapel an.The order of the behavior element extensions in a behavior indicates their positions in the stack. Elemente oben im Stapel werden zuerst übernommen.Elements at the top of the stack are applied first. So ändern Sie die ReihenfolgeTo change the ordering:

  1. Wählen Sie einen der Verhaltensknoten aus.Select one of the behavior nodes.

  2. Markieren Sie das zu bearbeitende Verhalten.Select the behavior you want edit.

  3. Wählen Sie ein verhaltenserweiterungselement in der Verhaltenselementerweiterungs-Position Abschnitt.Select a behavior extension element in the Behavior Element Extension Position section.

  4. Verwenden der einrichten oder unten Schaltfläche auf der linken Seite der Liste, um die Position des ausgewählten Elements zu ändern.Use the Up or Down button on the left side of the list to change the position of the selected element.

Bearbeiten der Konfiguration von VerhaltenselementerweiterungenEditing the Configuration of Behavior Element Extensions
  1. Wählen Sie einen der Verhaltensknoten in der Struktur aus.Select one of the behavior nodes in the tree.

  2. Wählen Sie das Verhalten aus, das das zu bearbeitende Element enthält.Select the behavior that contains the element you want to edit.

  3. Wählen Sie die Verhaltenselementerweiterung aus, die Sie bearbeiten möchten.Select the behavior element extension you want to edit. Die Einstellungen des Elements werden im rechten Bereich angezeigt, wo sie bearbeitet werden können.The settings of the element appear in the right pane where they can be edited.

ProtocolMappingProtocolMapping

Mit diesem Abschnitt können Sie Standardbindungstypen für andere Protokolle, wie z. B. http, tcp, MSMQ oder net.pipe, über die definierte Zuordnung zwischen Protokolladressschemas und den möglichen Bindungen festlegen.This section allows you to set default binding types for different protocols such as http, tcp, MSMQ or net.pipe through defined mapping between protocol address schemes and the possible bindings. Sie können darüber hinaus anderen Protokollen neue Zuordnungen hinzufügen.You can also add new mappings to other protocols.

ErweiterungenExtensions

Neue bindungserweiterungen, bindungselementerweiterungen, standardendpunkterweiterungen und verhaltenserweiterungen können für die Verwendung in WCF-Konfiguration registriert werden.New binding extensions, binding element extensions, standard endpoint extensions and behavior extensions can be registered for use in WCF configuration. Erweiterungen sind Name-/Typpaare.Extensions are name/type pairs. Der Name definiert den Namen der Erweiterung in der Konfiguration, wohingegen der Typ die Erweiterung implementiert.The name defines the name of the extension in configuration, whereas the type implements the extension. Es gibt vier Erweiterungstypen:There are four types of extensions:

  • Bindungserweiterungen definieren einen gesamten Bindungstyp.Binding extensions define an entire binding type. Beispiel: basicHttpBindingExample: basicHttpBinding.

  • Bindungselementerweiterungen definieren ein Element einer Bindung.Binding element extensions define an element of a binding. Beispiel: textMessageEncodingExample: textMessageEncoding.

  • Standardendpunkterweiterungen definieren einen gesamten Standardendpunkt.Standard endpoint extensions define an entire standard endpoint. Beispiel: discoveryEndpointExample: discoveryEndpoint.

  • Verhaltenselementerweiterungen definieren ein Element eines Verhaltens.Behavior element extensions define an element of a behavior. Beispiel: clientViaExample: clientVia.

Erweiterungen, die in einer Konfiguration registriert wurden, können wie jede andere WCF-Komponente des gleichen Typs verwendet werden.Extensions that have been registered in configuration can be used like any other WCF component of the same type.

Hinzufügen einer neuen ErweiterungAdding a new extension

Wählen Sie einen der Erweiterungsknoten in den erweiterten Knoten aus:Select one of the extension nodes in the advanced nodes:

  1. Klicken Sie auf neue.Click New.

  2. Geben Sie einen Namen und einen Typ ein.Enter a name and type.

  3. Klicken Sie auf OK.Click OK.

  4. Die Erweiterung wird jetzt an der entsprechenden Stelle im Editor angezeigt.The extension now appears in the appropriate place in the Editor. Wenn Sie z. B. eine Verhaltenselementerweiterung hinzufügen, wird sie in der Liste verfügbarer Erweiterungen angezeigt.For example, if you add a behavior element extension, it appears in the list of available extensions.

HostumgebungHosting Environment

Dieser Abschnitt ermöglicht Ihnen, Instanziierungseinstellungen für die Diensthostingumgebung zu definieren.This section allows you to define instantiation settings for the service hosting environment.

Erstellen einer Konfigurationsdatei mit dem AssistentenCreating a Configuration File Using the Wizard

Eine Möglichkeit zum Erstellen einer neuen Konfigurationsdatei ist die Verwendung des Assistenten für neue Dienstelemente.One way to create a new configuration file is to use the New Service Element Wizard. Der Assistent sucht nach den installierten Diensttypen und andere Elemente mit WCF auf dem Computer, einschließlich COM+- und im Internet gehostete virtuelle Verzeichnisse kompatibel und lädt diese, um die Erstellung der Konfigurations zu straffen.The wizard finds the installed service types and other elements compatible with WCF on the computer, including COM+ and Web-hosted virtual directories, and loads them to make creating the configuration much more streamlined.

Erstellen einer KonfigurationsdateiCreating a Configuration File

  1. Starten Sie ein Befehlsfenster, das auf den WCF-Installationspfad navigieren, und geben Sie dann mit Dienstkonfigurations-Editor SvcConfigEditor.exe.Start Service Configuration Editor by using a command window to navigate to your WCF installation location, and then type SvcConfigEditor.exe.

  2. Aus der Datei klicken Sie im Menü öffnen , und klicken Sie auf ausführbare Datei, COM+ Service, oder WebHosted Service, je nach dem Typ der Konfigurationsdatei, die Sie erstellen möchten.From the File menu, select Open and click Executable, COM+ Service, or WebHosted Service, depending on the type of configuration file you want to create.

  3. In der öffnen Dialogfeld navigieren Sie zu der Datei, Sie verwenden möchten, erstellen eine Konfigurationsdatei für, und doppelklicken darauf.In the Open dialog box, navigate to the specific file you want to create a configuration file for and double-click it.

  4. In der Datei Sie im Menü neues Element hinzufügen , und klicken Sie auf Service.In the File menu, point to Add New Item and click Service. Der Assistent für neue Dienstelemente wird geöffnet.The New Service Element Wizard opens.

  5. Folgen Sie den Schritten im Assistenten, um den neuen Dienst zu erstellen.Follow the steps in the wizard to create the new service.

Hinweis

Wenn Sie die NetPeerTcpBinding aus der vom Assistenten generierten Konfigurationsdatei verwendet möchten, müssen Sie manuell ein Bindungskonfigurationselement hinzufügen und das mode-Attribut seines security-Elements in "None" ändern.If you want to use the NetPeerTcpBinding from the configuration file generated by the Wizard, you have to manually add a binding configuration element and modify the mode attribute of its security element to "None".

Konfigurieren von COM+Configuring COM+

Mit dem Service Configuration Editor können Sie eine neue Konfigurationsdatei für eine vorhandene COM+-Anwendung erstellen oder eine vorhandene COM+-Konfiguration bearbeiten.The Service Configuration Editor enables you to create a new configuration file for an existing COM+ application, or edit an existing COM+ configuration. Die COM-Vertrag Knoten ist nur sichtbar, wenn die <comContract> Abschnitt in der Konfigurationsdatei vorhanden ist.The COM Contract node is only visible when the <comContract> section exists in the configuration file.

Erstellen einer neuen COM+-KonfigurationsdateiCreating a New COM+ Configuration

Stellen Sie vor dem Erstellen einer neuen COM+-Konfiguration sicher, dass die COM+-Anwendung in den Komponentendiensten installiert und im globalen Assemblycache (GAC) registriert ist.Before creating a new COM+ configuration, make sure that your COM+ application is installed in Component Services, and registered in the Global Assembly Cache (GAC).

  1. Wählen Sie Datei -> integrieren -> COM+-Anwendung.Select File menu -> Integrate -> COM+ Application. Hierdurch wird die gerade geöffnete Datei geschlossen.This operation closes the current opened file. Wenn die Datei noch nicht gespeicherte Daten enthält, wird ein Dialogfeld zum Speichern angezeigt.If there is unsaved data in the current file, a Save dialog appears. Die COM+-Integrations-Assistent wird gestartet.The COM+ Integration Wizard is then launched.

  2. Wählen Sie auf der ersten Seite die COM+-Anwendung in der Struktur.In the first page, select the COM+ application from the tree. Wenn die COM+-Anwendung nicht in der Struktur angezeigt wird, überprüfen Sie, ob sie in den Komponentendiensten installiert und im globalen Assemblycache (GAC) registriert ist.If you cannot find your COM+ application in the tree, verify that it is installed in the Component Services and registered in the Global Assembly Cache (GAC).

  3. Wählen Sie auf der nächsten Seite, welche Methode(n) Sie als WCF-Dienste verfügbar machen möchten.In the next page, select which method(s) you want to expose as WCF services. Alle unterstützten Methoden in der COM+-Anwendung werden angezeigt und sind standardmäßig ausgewählt.All the supported methods in the COM+ application are displayed and selected by default.

  4. Wählen Sie eine Hostingmethode aus.Choose a hosting method.

  5. Konfigurieren Sie andere Einstellungen entsprechend den Richtlinien des Assistenten.Configure other settings according to the guides in the wizard.

  6. Der Service Configuration Editor nutzt ComSvcConfig.exe im Hintergrund, um eine Konfigurationsdatei zu generieren.Service Configuration Editor utilizes ComSvcConfig.exe in the background to generate configuration file. Nachdem dies abgeschlossen wurde, können Sie eine Zusammenfassung anzeigen und den Assistenten beenden.After this is completed, you can view a summary and exit the wizard. Die generierte Konfigurationsdatei wird geöffnet, damit Sie diese direkt bearbeiten können.The generated configuration file is opened so that you can edit it directly.

Bearbeiten einer vorhandenen COM+-KonfigurationEditing an Existing COM+ Configuration

  1. Wählen Sie Datei -> öffnen -> COM+ Service...Select File menu -> Open -> COM+ Service

  2. Wählen Sie den zu bearbeitenden COM+-Dienst aus der Liste aus.Select the COM+ Service you want to edit from the list.

  3. Bearbeiten Sie Konfigurationseinstellungen in die COM-Verträge Knoten.Edit configuration settings in the COM Contracts node.

    Hinweis

    Sie können eine Konfigurationsdatei mit COM+-Verträgen auch direkt öffnen und bearbeiten.You can also directly open and edit a configuration file that contains COM contracts.

SicherheitSecurity

Eine durch den Configuration Editor generierte Dienstkonfigurationsdatei ist nicht garantiert sicher.A service configuration file generated by the Configuration Editor is not guaranteed to be secure. Finden Sie in der Sicherheit Dokumentation, um herauszufinden, wie Ihre WCF-Dienste zu schützen.Please refer to the Security documentation to find out how to secure your WCF services.

Außerdem kann der Configuration Editor nur verwendet werden, um gültige WCF-Konfigurationselemente zu lesen und zu schreiben.In addition, the Configuration Editor can only be used to read and write valid WCF configuration elements. Das Tool ignoriert schemakompatible, benutzerdefinierte Elemente.The tool ignores schema-compliant, user-defined elements. Es versucht außerdem nicht, diese Elemente aus der Konfigurationsdatei zu entfernen oder die Auswirkungen auf die bekannten WCF-Elemente zu ermitteln.It also does not attempt remove these elements from the configuration file or determine their effects on the known WCF elements. Es ist die Aufgabe des Benutzers, zu ermitteln, ob diese Elemente eine Bedrohung für die Anwendung oder das System darstellen.It is the user’s responsibility to determine whether these elements pose a threat to the application or the system.