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 gestartet haben, können Sie im Menü Datei/öffnen nach dem Dienst oder der Assembly suchen, 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 den Dienstkonfigurations-Editor, indem Sie in einem Befehlsfenster zum WCF-Installations Speicherort navigieren, und geben Sie dann SvcConfigEditor.exe ein.Start Service Configuration Editor by using a command window to navigate to your WCF installation location, and then type SvcConfigEditor.exe.

  2. Wählen Sie im Menü Datei die Option Öffnen aus, und klicken Sie auf den Dateityp, den Sie verwalten möchten.From the File menu, select Open and click the type of file you want to manage.

  3. Navigieren Sie im Dialogfeld Öffnen zu der Datei, die Sie verwalten möchten, und doppelklicken Sie 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. Die tatsächliche Konfiguration eines nicht gehosteten Dienstanbieter ist beispielsweise eine Kombination aus "Machine. config" und "App. config". Alle Änderungen werden auf die aktive Datei im SvcConfigEditor angewendet.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 den Konfigurationsmerge 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

Der Knoten Dienste zeigt alle Dienste an, die zurzeit in der Konfigurationsdatei zugewiesen sind.The Services node displays all of the services currently assigned in the configuration file. Jeder unter Knoten in der Struktur entspricht einem Unterelement des < services >-Elements in der Konfigurationsdatei.Each sub-node in the tree corresponds to a sub-element of the <services> element in the configuration file.

Wenn Sie auf den Knoten Dienste klicken, können Sie auf der Seite Dienst Zusammenfassung im Detail Bereich Aufgaben anzeigen oder ausführen.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 neuen Dienst erstellen...Using a Wizard: Click the link Create a New Service… im Aufgabenbereich oder auf der Zusammenfassungs Seite, um den Assistenten zu starten.on the Task Pane or Summary Page to launch the wizard. Sie können dies auch im Menü Datei > Neues Element hinzufügen.You can also do so in the File menu -> Add New Item.

  • Manuell erstellen: Sie können mit der rechten Maustaste auf den Knoten Dienste klicken und neuer Dienstauswählen.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 mithilfe eines Assistenten: Klicken Sie auf den Link neuen Dienst Endpunkt erstellen...Create using a Wizard: click the link Create a New Service Endpoint… im Aufgabenbereich oder auf der Zusammenfassungs Seite, um den Assistenten zu starten.on the Task Pane or Summary Page to launch the wizard. Sie können dies auch im Menü Datei > Neues Element hinzufügen.You can also do so in the File menu -> Add New Item.

  • Manuelles Erstellen: Nachdem Sie einen Dienst erstellt haben, können Sie mit der rechten Maustaste auf den Knoten Endpunkte klicken und dann "neuer Dienst Endpunkt" auswählen.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 einen Dienst 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 einen Dienst Endpunkt -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 den Host Knoten.Click the Host node.

  2. Klicken Sie auf die neue...Click the New… im Abschnitt " Basisadressen ".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 den Wert von <baseadresssedifixfilters > in diesem Tool nicht bearbeiten.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

Der Client Knoten zeigt alle Client Endpunkte in der Konfigurationsdatei an.The Client node displays all of the client endpoints in the configuration file. Jeder unter Knoten in der Struktur entspricht einem Unterelement des < client >-Elements in der Konfigurationsdatei.Every sub-node in the tree corresponds to a sub-element of the <client> element in the configuration file.

Wenn Sie auf den Client Knoten klicken, können Sie auf der Seite Client Zusammenfassung im DetailBereich Aufgaben anzeigen oder ausführen.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:

  • Create by Wizard: Klicken Sie auf den Link neuen Client erstellen...Create by Wizard: Click the link Create a New Client… im Aufgaben Bereich links unten im Fenster oder auf der Zusammenfassungs Seite , 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 dies auch im Menü 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.

  • Manuell erstellen: Klicken Sie mit der rechten Maustaste auf den Knoten Endpunkte unter Client, und wählen Sie neuer Client Endpunktaus.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 einen Client Endpunkt -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 im Standard Endpunkt -Knoten gespeichert.Such configuration settings are stored in the Standard Endpoint node. Der Knoten Standard Endpunkt zeigt alle Standard Endpunkt Einstellungen in der Konfigurationsdatei an.The Standard Endpoint node displays all of the standard endpoint settings in the configuration file. Jeder unter Knoten in der Struktur entspricht einem Unterelement im <standardEndpoints>-Element in der Konfigurationsdatei.Every sub-node in the tree corresponds to a sub-element in the <standardEndpoints> element in the configuration file.

Wenn Sie auf den Standard Endpunkt -Knoten klicken, können Sie auf der Seite Standard-Endpunkt Zusammenfassung im DetailBereich Aufgaben anzeigen oder ausführen.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:

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

  • Wählen Sie den Knoten Standard Endpunkt aus, und klicken Sie auf neue standardend Punkt Konfiguration...Select the Standard Endpoint node and click New Standard Endpoint Configuration… im Aufgaben Bereich links unten im Fenster.in the Task Pane on the lower-left of the window.

Im Dialogfeld Erstellen eines neuen Standard Endpunkts werden alle registrierten standardend Punkt Typen angezeigt.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, um den Standard Endpunkt Knoten zu erweitern, und klicken Sie auf den entsprechenden Endpunkt unter Knoten.Click to expand the Standard Endpoint node and click the respective endpoint sub-node.

  • Klicken Sie auf den Knoten Standard Endpunkt , und klicken Sie im Detail Bereich auf den entsprechenden Endpunkt.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, um den Standard Endpunkt Knoten zu erweitern, und klicken Sie mit der rechten Maustaste auf den entsprechenden Endpunkt unter Knoten.Click to expand the Standard Endpoint node and right-click the respective endpoint sub-node. Verwenden Sie den Kontext Befehl Standard Endpunkt Konfiguration löschen , um den Endpunkt zu löschen.Use the context command Delete Standard Endpoint Configuration to delete the endpoint.

  • Klicken Sie auf den Knoten Standard Endpunkt .Click the Standard Endpoint node. Klicken Sie im Aufgaben Bereich auf Standard Endpunkt Konfiguration löschen.In the Task pane, click Delete Standard Endpoint Configuration.

Wenn der Standard Endpunkt verwendet wird, wird eine Warnmeldung angezeigt, wenn Sie versuchen, Sie zu löschen: der Standard Endpunkt wird verwendet. Wenn Sie Sie jetzt löschen, achten Sie darauf, alle Verweise in anderen Teilen der Konfiguration zu löschen (z. b. im Dienst Endpunkt oder Client Endpunkt). Andernfalls ist die Konfiguration ungültig und kann nicht das nächste Mal geöffnet werden. Möchten Sie den Standard Endpunkt wirklich löschen? "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 im Bindungs Knoten gespeichert.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.

Der Knoten Bindungen zeigt alle Bindungs Einstellungen in der Konfigurationsdatei an.The Bindings node displays all of the binding settings in the configuration file. Jeder unter Knoten in der Struktur entspricht einem Unterelement im < bindings-> Element in der Konfigurationsdatei.Every sub-node in the tree corresponds to a sub-element in the <bindings> element in the configuration file.

Wenn Sie auf den Knoten Bindungen klicken, können Sie auf der Seite Bindungs Zusammenfassung im DetailBereich Aufgaben anzeigen oder ausführen.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.

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

  • Wählen Sie den Knoten Bindungen aus, und klicken Sie auf neue Bindungs Konfiguration...Select the Bindings node and click New Binding Configuration im Aufgaben Bereich links unten im Fenster.in the Task Pane on the lower-left of the window.

  • Klicken Sie auf der Seite Dienst-oder Client Zusammenfassung im Feld Bindungs Konfiguration auf zum Erstellen klicken , um eine Bindungs Konfiguration 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 im Abschnitt Bindungs Element-Erweiterungs Position ein Bindungs Erweiterungs Element aus.Select one binding extension element in the Binding Element Extension Position section.

  3. Verwenden Sie die nach- oben -oder nach-unten -Taste 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

Der Diagnose Knoten zeigt alle Diagnose Einstellungen in der Konfigurationsdatei an.The Diagnostics node displays all of the diagnostic settings in the configuration file. Sie ermöglicht es Ihnen, Leistungsindikatoren ein-oder auszuschalten, Windows-Verwaltungsinstrumentation (WMI) zu aktivieren oder deaktivieren, die WCF-Ablauf Verfolgung zu konfigurieren und die WCF-Nachrichten Protokollierung zu 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 im Diagnose Knoten entsprechen dem Abschnitt < system.diagnostics > und <diagnostics> im <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.

Wenn Sie auf den Diagnose Knoten klicken, können Sie im DetailBereich auf der Seite "Diagnose Zusammenfassung " Aufgaben anzeigen oder ausführen.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 den Knoten Diagnose .Click the Diagnostics node.

  2. Klicken Sie auf Leistungsindikatoren umschalten.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 den Knoten Diagnose .Click the Diagnostics node.

  2. Um den WMI-Anbieter zu aktivieren, klicken Sie auf den Link WMI-Anbieter aktivieren .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 den Knoten Diagnose .Click the Diagnostics node.

  2. Klicken Sie auf Ablauf Verfolgung aktivieren.Click Enable Tracing.

  3. Klicken Sie auf den Link Ablauf Verfolgungs Ebene , um die Ablauf Verfolgungs Ebene anzupassen.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. Mithilfe der Option Aktivitäts Ablauf Verfolgung und Aktivität propagieren können Sie die Funktion für die WCF-Aktivitäts Ablauf Verfolgung 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 den Knoten Diagnose .Click the Diagnostics node.

  2. Klicken Sie auf Nachrichten Protokollierung aktivieren.Click Enable Message Logging.

  3. Klicken Sie auf den Link Protokollebene , um die Protokollebene anzupassen.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, dass die Ablauf Verfolgungs-und Nachrichten Protokolle automatisch geleert werden, wenn die Anwendung geschlossen wird, aktivieren Sie die Option Auto Flush .If you want the trace and message logs to be flushed automatically when your application is closed, enable the Auto Flush option.

Auf der Seite " Diagnose Zusammenfassung " können Sie die gängigsten Aufgaben beim Konfigurieren der Diagnose ausführen.The Diagnostics Summary Page enables you to accomplish the most common tasks in configuring diagnostics. Wenn Sie jedoch die Listener-und Quellen Einstellungen manuell bearbeiten möchten, müssen Sie den Diagnose Knoten erweitern und die Einstellungen im Knoten Nachrichten Protokollierung, Listener und Quellen bearbeiten.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 den Diagnose Knoten, und erweitern Sie ihn.Click the Diagnostics node, and expand it.

  2. Klicken Sie mit der rechten Maustaste auf den Knoten Listener, und wählen Sie neuer ListenerRight-click the Listeners node and select New Listener.

  3. Geben Sie den Namen der Ablauf Verfolgungs Datei im initdata -Feld ein.Type in the trace file name in the InitData field. Sie können auf die "..." , um zu einem Pfad zu navigieren.You can click the "…" button to browse to a path.

  4. Wenn Sie auf die Zeile tytzame klicken, wird ein "..." angezeigt. gedrückt.Clicking the TypeName line displays a "…" button. Klicken Sie auf diese Schaltfläche, um den Typdes Ablaufverfolgungslistener zu öffnen, mit dem Sie vorkonfigurierte Ablaufverfolgungslistener suchen könnenClick 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 den Abschnitt " Quelle ".Note the Source section. Klicken Sie in diesem Abschnitt auf Hinzufügen , um ein Dialogfeld mit einem Dropdown Menü zu öffnen, in dem verfügbare Ablauf Verfolgungs Quellen aufgelistet 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 Ablauf Verfolgungs Quelle aus und klicken Sie auf OKSelect a tracing source and click OK.

  6. Klicken Sie zum Bearbeiten der Einstellungen für die Nachrichten Protokollierung auf den Knoten Nachrichten Protokollierung .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

Der Knoten Verhalten zeigt die Verhalten an, die zurzeit 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 im erweiterten Knoten unter Dienst Verhalten und Endpunkt Verhaltengespeichert.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.

  • Klicken Sie mit der rechten Maustaste auf einen der Verhaltens Knoten, und wählen Sieneue Verhaltens Konfiguration...Right-click one of the behavior nodes and select "New Behavior Configuration…

  • Wählen Sie einen der Verhaltens Knoten aus, und klicken Sie auf die neue Verhaltens Konfiguration...Select one of the behavior nodes and click the New Behavior Configuration im Aufgaben Bereich links unten im Fenster.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 im Abschnitt Verhaltens Element-Erweiterungs Position ein Verhaltens Erweiterungs Element aus.Select a behavior extension element in the Behavior Element Extension Position section.

  4. Verwenden Sie die nach- oben -oder nach-unten -Taste 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 Bindungs Erweiterungen, Bindungs Element Erweiterungen, standardend Punkt Erweiterungen und Verhaltens Erweiterungen können für die Verwendung in der 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 New (Neu).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 ermittelt die installierten Dienst Typen und andere Elemente, die mit WCF auf dem Computer kompatibel sind, einschließlich com+-und im Internet gehosteter virtueller Verzeichnisse, und lädt diese, um die Erstellung der Konfiguration zu vereinfachen.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 den Dienstkonfigurations-Editor, indem Sie in einem Befehlsfenster zum WCF-Installations Speicherort navigieren, und geben Sie dann SvcConfigEditor.exe ein.Start Service Configuration Editor by using a command window to navigate to your WCF installation location, and then type SvcConfigEditor.exe.

  2. Wählen Sie im Menü Datei die Option Öffnen aus, und klicken Sie abhängig vom Typ der Konfigurationsdatei, die Sie erstellen möchten, auf ausführbare Datei, com+-Dienstoder webgehosteter Dienst.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. Navigieren Sie im Dialogfeld Öffnen zu der spezifischen Datei, für die Sie eine Konfigurationsdatei erstellen möchten, und doppelklicken Sie darauf.In the Open dialog box, navigate to the specific file you want to create a configuration file for and double-click it.

  4. Zeigen Sie im Menü Datei auf Neues Element hinzufügen , und klicken Sie auf Dienst.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. Der com-Vertrags Knoten ist nur sichtbar, wenn der < 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 das Menü Datei aus, > -> com+-Anwendung integrieren.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. Anschließend wird der com+-Integrations-Assistent 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. Menü " Datei auswählen" > -> com+-Dienst Öffnen...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 die Konfigurationseinstellungen im Knoten com-Verträge .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. Informationen zum Sichern Ihrer WCF-Dienste finden Sie in der Dokumentation zur Sicherheit .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.