Durchführen der Windows Communication Foundation-BeispieleRunning the Windows Communication Foundation Samples

Der Windows Communication Foundation (WCF)-Beispiele können in einer Konfiguration mit einem einzelnen Computer oder computerübergreifend ausgeführt werden.The Windows Communication Foundation (WCF) samples can be run in a single-machine or cross-machine configuration. Wie angegeben, können die Beispiele auf einem einzelnen Computer ausgeführt werden.As supplied, the samples are ready for running on a single machine. In einer computerübergreifenden Konfiguration ist es notwendig, die Konfigurationsdateieinstellungen des Beispiels zu ändern.In a cross-machine configuration, it is necessary to modify a sample's configuration file settings. Die folgenden Prozeduren erklären, wie ein Beispiel in einer Konfiguration mit einem einzelnen Computer und computerübergreifend ausgeführt wird.The following procedures explain how to run a sample in same-machine and cross-machine configurations. Beachten Sie, dass es Abweichungen in den Schritten für Dienste, die in Internetinformationsdiensten (IIS) gehostet werden, und den selbst gehosteten Diensten gibt.Note that there are variations in the steps for services hosted in Internet Information Services (IIS) and the self-hosted samples. Die meisten Beispiele werden in IIS gehostet. Der Infodatei eines Beispiels können Sie entnehmen, wie das Beispiel gehostet wird.Most samples are hosted in IIS; see the sample readme information to determine how it is hosted.

Bei Windows VistaWindows Vista erfordern Beispiele, die nicht in IIS gehostet werden, erweiterte Berechtigungen, um einen Listener mit "Http.sys" zu registrieren.On Windows VistaWindows Vista, samples that are not hosted in IIS require elevated privileges to register a listener with Http.sys. Verwenden Sie Httpcfg.exe, um die Überwachungsadressen des Diensts mit dem Konto, unter dem der Dienst ausgeführt wird, zu registrieren, oder starten Sie den Dienst an einer Eingabeaufforderung, die mit Administratorrechten ausgeführt wird.Use Httpcfg.exe to register the service's listening addresses with the account the service is running under, or launch the service from a command prompt running with administrator privileges.

Hinweis

Vor dem Erstellen oder einen WCF-Beispiele ausführen, werden Sie sicher, dass Sie ausgeführt haben die Setupprozedur für die Windows Communication Foundation-Beispiele zum einmaligen.Before building or running any of the WCF samples, be sure you have performed the One-Time Setup Procedure for the Windows Communication Foundation Samples.

So führen Sie das Beispiel auf demselben Computer ausTo run the sample on the same machine

  1. Wenn der Dienst von IIS gehostet wird, stellen Sie sicher, dass Sie den Dienst mithilfe eines Browsers durch Eingabe der folgenden Adresse zugreifen können: http://localhost/servicemodelsamples/service.svc.If the service is hosted by IIS, ensure that you can access the service using a browser by entering the following address: http://localhost/servicemodelsamples/service.svc. Als Antwort sollte eine Bestätigungsseite angezeigt werden.A confirmation page should be displayed in response. Wenn die Seite "Bestätigung" nicht angezeigt wird, finden Sie unter Tipps zur Problembehandlung.If the confirmation page is not displayed, see Troubleshooting Tips.

  2. Wenn der Dienst selbst gehostet ist, führen Sie "Service.exe" aus "\service\bin" im sprachspezifischen Ordner aus.If the service is self-hosted, run Service.exe from \service\bin, from under the language-specific folder. Im Dienstkonsolenfenster wird die Dienstaktivität angezeigt.Service activity is displayed on the service console window.

  3. Führen Sie Client.exe aus \client\bin\, unter dem sprachspezifischen Ordner.Run Client.exe from \client\bin\, from under the language-specific folder. Im Clientkonsolenfenster wird die Clientaktivität angezeigt.Client activity is displayed on the client console window.

  4. Wenn Client und Dienst nicht miteinander kommunizieren können, finden Sie unter Tipps zur Problembehandlung.If the client and service are not able to communicate, see Troubleshooting Tips.

So führen Sie das Beispiel computerübergreifend ausTo run the sample across machines

  1. Wenn der Dienst in IIS gehostet wird:If the service is hosted in IIS:

    1. Erstellen Sie auf dem Dienstcomputer ein virtuelles Verzeichnis namens "ServiceModelSamples".On the service machine, create a virtual directory named ServiceModelSamples. Die Batchdatei Setupvroot.bat enthaltene Setupprozedur für die Windows Communication Foundation-Beispiele zum einmaligen zum Erstellen des festplattenverzeichnisses und des virtuellen Verzeichnisses verwendet werden können.The batch file Setupvroot.bat included with One-Time Setup Procedure for the Windows Communication Foundation Samples can be used to create the disk directory and virtual directory.

    2. Kopieren Sie die Dienstprogrammdateien aus %SystemDrive%\Inetpub\wwwroot\servicemodelsamples in das virtuelle Verzeichnis "ServiceModelSamples" auf dem Dienstcomputer.Copy the service program files from %SystemDrive%\Inetpub\wwwroot\servicemodelsamples to the ServiceModelSamples virtual directory on the service machine. Stellen Sie sicher, dass Sie die Dateien in das Verzeichnis \bin einfügen können.Ensure that you include the files in the \bin directory.

    3. Testen Sie, ob Sie mit einem Browser vom Clientcomputer auf den Dienst zugreifen können.Test that you can access the service from the client machine using a browser.

    Wenn der Dienst selbst gehostet wird:If the service is self-hosted:

    1. Erstellen Sie auf dem Dienstcomputer ein Verzeichnis, das die Dienstdateien enthalten soll.On the service machine, create a directory to hold the service files.

    2. Kopieren Sie die Dienstprogrammdateien aus dem Ordner "\service\bin" (unterhalb des sprachspezifischen Ordners) auf den Dienstcomputer.Copy the service program files from the \service\bin\ folder, under the language-specific folder, to the service machine.

    3. Ändern Sie in der Dienstkonfigurationsdatei den Wert für die Adresse der Endpunktdefinition so, dass er mit der neuen Adresse Ihres Diensts übereinstimmt.In the service configuration file, change the address value of the endpoint definition to match the new address of your service. Ersetzen Sie alle Verweise auf localhost in der Adresse durch einen vollqualifizierten Domänennamen.Replace any references to "localhost" with a fully-qualified domain name in the address.

    4. Führen Sie an einer Eingabeaufforderung "Service.exe" aus.Launch Service.exe from a command prompt.

  2. Kopieren Sie die Clientprogrammdateien aus dem Ordner "\client\bin" (unterhalb des sprachspezifischen Ordners) auf den Clientcomputer.Copy the client program files from the \client\bin\ folder, under the language-specific folder, to the client machine.

  3. Richten Sie die Endpunktadresse ein.Set the endpoint address.

    1. Wenn der Dienst nicht unter einem Domänenkonto ausgeführt wird, öffnen Sie die Konfigurationsdatei, und ändern Sie den Wert für die Adresse der Endpunktdefinition so, dass er mit der neuen Adresse Ihres Diensts übereinstimmt.If the service is not running under a domain account, open the client configuration file and change the address value of the endpoint definition to match the new address of your service. Ersetzen Sie alle Verweise auf localhost in der Adresse durch einen vollqualifizierten Domänennamen.Replace any references to "localhost" with a fully-qualified domain name in the address.

    2. Wenn der Dienst unter einem Domänenkonto ausgeführt wird, generieren Sie die Clientkonfiguration neu, indem Sie "Svcutil.exe" für den Dienst ausführen.If the service is running under a domain account, regenerate the client configuration by running Svcutil.exe against the service. Weitere Informationen zum Ausführen von Svcutil.exe, finden Sie unter Erstellen der Windows Communication Foundation-Beispiele.For more information about running Svcutil.exe, see Building the Windows Communication Foundation Samples. Verwenden Sie die generierte Datei statt der Konfigurationsdatei im Beispiel.Use the generated file instead of the configuration file in the sample. Die generierte Konfigurationsdatei verfügt über zusätzliche Identitätsinformationen und enthält alle Einstellungen, die notwendig sind, um eine Verbindung zum Dienstendpunkt aufzubauen, auch wenn diese die Standardeinstellungen sind.The generated configuration file has additional identity information, and contains all settings necessary to connect to the service endpoint even though they are the default settings. Weitere Informationen zu Identitätsinformationen, finden Sie unter -Dienstidentität und Authentifizierung, und <Identität >.For more information about identity information, see Service Identity and Authentication, and <identity>.

  4. Starten Sie auf dem Clientcomputer in einer Eingabeaufforderung die Datei "Client.exe".On the client machine, launch Client.exe from a command prompt.

So debuggen Sie einen DienstTo debug a service

  1. Erstellen der Projektmappe (sowohl Client als auch Service) mit der erstellen Menüs oder STRG + UMSCHALT + B.Build the solution (both client and service) using the Build menu or CTRL+SHIFT+B.

  2. Wenn der Dienst in IIS gehostet wird:If the service is hosted in IIS:

    1. Aktivieren Sie den Dienst mithilfe eines Browsers durch Eingabe der Adresse http://localhost/servicemodelsamples/service.svc.Activate the service using a browser by entering the address http://localhost/servicemodelsamples/service.svc.

    2. Wählen Sie in der Projektmappe die Debuggen Menü und die an den Prozess anhängen Menüelement.In the solution, choose the Debug menu and the Attach to Process menu item.

    3. Wählen Sie die Prozesse aller Benutzer anzeigen Kontrollkästchen.Select the Show processes from all users check box.

    4. Wählen Sie zum Debuggen den Hostarbeitsprozess „W3wp.exe“ aus (unter Windows XP wählen Sie „ASPNet_wp.exe“ aus).Select the host worker process W3wp.exe to debug (select ASPNet_wp.exe on Windows XP).

  3. Sie können jetzt Haltepunkte im Dienstcode festlegen und Haltepunkte für Ausnahmen aktivieren.You can now set breakpoints in the service code and enable breakpoints on exceptions.

  4. Mit der rechten Maustaste des clientprojektelement, und wählen Sie Debuggen, neue Instanz starten.Right-click the client project item and choose Debug, Start new instance.

So stellen Sie den Zustand vor Ausführung des Beispiels wieder herTo clean up after the sample

  • Wenn der Dienst in IIS gehostet wird, entfernen Sie aus Sicherheitsgründen die Definition des virtuellen Verzeichnisses und die in den Setupschritten gewährten Berechtigungen, wenn Sie die Beispiele abgeschlossen haben.If the service is hosted in IIS for security purposes, remove the virtual directory definition and permissions granted in the setup steps when you are finished with the samples.

Siehe auchSee Also

Erstellen der Windows Communication Foundation-BeispieleBuilding the Windows Communication Foundation Samples
Die Beispiele in einer Arbeitsgruppe und computerübergreifend ausgeführtRunning the Samples in a Workgroup and Across Machines
Tipps zur ProblembehandlungTroubleshooting Tips