Freigeben über

Durchführen der Windows Communication Foundation-Beispiele

Die Windows Communication Foundation (WCF)-Beispiele können in einer Einzelcomputer- oder netzwerkübergreifenden Konfiguration ausgeführt werden. Wie bereitgestellt, können die Beispiele auf einem einzigen Computer ausgeführt werden. In einer computerübergreifenden Konfiguration ist es erforderlich, die Konfigurationsdateieinstellungen eines Beispiels zu ändern. In den folgenden Verfahren wird erläutert, wie Sie eine Probe in derselben Maschine und maschinenübergreifenden Konfigurationen ausführen. Beachten Sie, dass es Abweichungen in den Schritten für Dienste, die in Internetinformationsdiensten (IIS) gehostet werden, und den selbst gehosteten Diensten gibt. Die meisten Beispiele werden in IIS gehostet; Sieh dir die README-Informationen zum Beispielprojekt an, um zu bestimmen, wie es gehostet wird.

Unter Windows Vista erfordern Beispiele, die nicht in IIS gehostet werden, erhöhte Berechtigungen, um einen Listener mit Http.syszu registrieren. Verwenden Sie Httpcfg.exe, um die Abhöradressen des Dienstes mit dem Konto zu registrieren, unter dem der Dienst ausgeführt wird, oder starten Sie den Dienst über eine Eingabeaufforderung mit Administratorrechten.

Hinweis

Stellen Sie vor dem Erstellen oder Ausführen eines der WCF-Beispiele sicher, dass Sie die One-Time Setupprozedur für die Windows Communication Foundation-Samples ausgeführt haben.

So führen Sie das Beispiel auf demselben Computer aus

  1. Wenn der Dienst von IIS gehostet wird, stellen Sie sicher, dass Sie mithilfe eines Browsers auf den Dienst zugreifen können, indem Sie die folgende Adresse eingeben: http://localhost/servicemodelsamples/service.svc Als Antwort sollte eine Bestätigungsseite angezeigt werden. Wenn die Bestätigungsseite nicht angezeigt wird, lesen Sie Problemlösungstipps für WCF-Beispiele.

  2. Wenn der Dienst selbst gehostet ist, führen Sie "Service.exe" aus "\service\bin" im sprachspezifischen Ordner aus. Die Dienstaktivität wird im Dienstkonsolenfenster angezeigt.

  3. Starten Sie Client.exe aus dem sprachspezifischen Ordner unter \client\bin\. Clientaktivität wird im Clientkonsolenfenster angezeigt.

  4. Wenn der Client und der Dienst nicht kommunizieren können, schauen Sie sich Tipps zur Problembehandlung für WCF-Samplesan.

So führen Sie das Beispiel computerübergreifend aus

  1. Wenn der Dienst in IIS gehostet wird:

    1. Erstellen Sie auf dem Dienstcomputer ein virtuelles Verzeichnis namens ServiceModelSamples. Die Batchdatei „Setupvroot.bat“ aus dem einmaligen Setupverfahren für Windows Communication Foundation-Beispiele kann zum Erstellen des Datenträgerverzeichnisses und des virtuellen Verzeichnisses verwendet werden.

    2. Kopieren Sie die Dienstprogrammdateien aus %SystemDrive%\Inetpub\wwwroot\servicemodelsamples in das virtuelle Verzeichnis ServiceModelSamples auf dem Dienstcomputer. Stellen Sie sicher, dass Sie die Dateien in das Verzeichnis "\bin" einschließen.

    3. Testen Sie, ob Sie über einen Browser auf den Dienst über den Clientcomputer zugreifen können.

    Wenn der Dienst selbst gehostet wird:

    1. Erstellen Sie auf dem Dienstcomputer ein Verzeichnis, das die Dienstdateien enthält.

    2. Kopieren Sie die Dienstprogrammdateien aus dem Ordner \service\bin\ unter dem sprachspezifischen Ordner auf den Dienstcomputer.

    3. Ändern Sie in der Dienstkonfigurationsdatei den Adresswert der Endpunktdefinition so, dass sie der neuen Adresse Ihres Diensts entspricht. Ersetzen Sie alle Verweise auf "localhost" durch einen vollqualifizierten Domänennamen in der Adresse.

    4. Führen Sie an einer Eingabeaufforderung "Service.exe" aus.

  2. Kopieren Sie die Clientprogrammdateien aus dem Ordner "\client\bin\" unter dem sprachspezifischen Ordner auf den Clientcomputer.

  3. Legen Sie die Endpunktadresse fest.

    1. Wenn der Dienst nicht unter einem Domänenkonto ausgeführt wird, öffnen Sie die Clientkonfigurationsdatei, und ändern Sie den Adresswert der Endpunktdefinition so, dass sie der neuen Adresse Ihres Diensts entspricht. Ersetzen Sie alle Verweise auf "localhost" durch einen vollqualifizierten Domänennamen in der Adresse.

    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. Weitere Informationen zum Ausführen von Svcutil.exefinden Sie unter Erstellen der Windows Communication Foundation-Beispiele. Verwenden Sie die generierte Datei anstelle der Konfigurationsdatei im Beispiel. Die generierte Konfigurationsdatei enthält zusätzliche Identitätsinformationen und enthält alle Einstellungen, die für die Verbindung mit dem Dienstendpunkt erforderlich sind, auch wenn sie die Standardeinstellungen sind. Weitere Informationen zu Identitätsinformationen finden Sie unter "Dienstidentität und Authentifizierung" und <"Identität">.

  4. Starten Sie auf dem Clientcomputer in einer Eingabeaufforderung die Datei "Client.exe".

So debuggen Sie einen Dienst

  1. Erstellen Sie die Projektmappe (sowohl Client als auch Dienst) mit dem Menü Erstellen oder STRG+UMSCHALT+B.

  2. Wenn der Dienst in IIS gehostet wird:

    1. Aktivieren Sie den Dienst mithilfe eines Browsers, indem Sie die Adresse http://localhost/servicemodelsamples/service.svceingeben.

    2. Wählen Sie in der Lösung das Menü "Debuggen " und das Menüelement " An Prozess anhängen " aus.

    3. Aktivieren Sie das Kontrollkästchen "Prozesse von allen Benutzern anzeigen ".

    4. Wählen Sie den Hostarbeitsprozess W3wp.exe aus, um zu debuggen (wählen Sie ASPNet_wp.exe unter Windows XP aus).

  3. Sie können jetzt Haltepunkte im Dienstcode festlegen und Haltepunkte für Ausnahmen aktivieren.

  4. Klicken Sie mit der rechten Maustaste auf das Clientprojektelement, und wählen Sie "Debuggen", " Neue Instanz starten" aus.

So stellen Sie den Zustand vor Ausführung des Beispiels wieder her

  • Wenn der Dienst zu Sicherheitszwecken in IIS gehostet wird, entfernen Sie die definition des virtuellen Verzeichnisses und die Berechtigungen, die in den Setupschritten erteilt wurden, wenn Sie mit den Beispielen fertig sind.

Siehe auch