Uruchamianie przykładów programu Windows Communication Foundation

Przykłady programu Windows Communication Foundation (WCF) można uruchamiać w konfiguracji pojedynczej maszyny lub między maszynami. Jak podano, próbki są gotowe do uruchamiania na jednej maszynie. W konfiguracji między maszynami konieczne jest zmodyfikowanie ustawień pliku konfiguracji przykładu. Poniższe procedury wyjaśniają sposób uruchamiania przykładu na tej samej maszynie i w konfiguracjach między maszynami. Należy pamiętać, że istnieją różnice w krokach usług hostowanych w usługach Internet Information Services (IIS) i przykładach hostowanych samodzielnie. Większość przykładów jest hostowanych w usługach IIS; Zobacz przykładowe informacje readme, aby określić, jak jest hostowana.

W systemie Windows Vista przykłady, które nie są hostowane w usługach IIS, wymagają podniesionych uprawnień do zarejestrowania odbiornika przy użyciu Http.sys. Użyj Httpcfg.exe, aby zarejestrować adresy nasłuchiwania usługi przy użyciu konta, w którym działa usługa, lub uruchomić usługę z poziomu wiersza polecenia uruchomionego z uprawnieniami administratora.

Uwaga

Przed utworzeniem lub uruchomieniem dowolnego z przykładów programu WCF upewnij się, że wykonano procedurę instalacji jednorazowej dla przykładów programu Windows Communication Foundation.

Aby uruchomić przykład na tej samej maszynie

  1. Jeśli usługa jest hostowana przez usługi IIS, upewnij się, że możesz uzyskać dostęp do usługi przy użyciu przeglądarki, wprowadzając następujący adres: http://localhost/servicemodelsamples/service.svc. W odpowiedzi powinna zostać wyświetlona strona potwierdzenia. Jeśli strona potwierdzenia nie jest wyświetlana, zobacz Troubleshooting Wskazówki for WCF Samples (Rozwiązywanie problemów z Wskazówki przykładów WCF).

  2. Jeśli usługa jest hostowana samodzielnie, uruchom Service.exe z folderu \service\bin z folderu specyficznego dla języka. Działanie usługi jest wyświetlane w oknie konsoli usługi.

  3. Uruchom Client.exe z folderu \client\bin\, z folderu specyficznego dla języka. Działanie klienta jest wyświetlane w oknie konsoli klienta.

  4. Jeśli klient i usługa nie mogą się komunikować, zobacz Rozwiązywanie problemów Wskazówki dla przykładów programu WCF.

Aby uruchomić przykład między maszynami

  1. Jeśli usługa jest hostowana w usługach IIS:

    1. Na maszynie usługi utwórz katalog wirtualny o nazwie ServiceModelSamples. Plik wsadowy Setupvroot.bat dołączony do jednorazowej procedury instalacji dla przykładów programu Windows Communication Foundation można użyć do utworzenia katalogu dysku i katalogu wirtualnego.

    2. Skopiuj pliki programu usługi z folderu %SystemDrive%\Inetpub\wwwroot\servicemodelsamples do katalogu wirtualnego ServiceModelSamples na maszynie usługi. Upewnij się, że pliki znajdują się w katalogu \bin.

    3. Przetestuj, czy możesz uzyskać dostęp do usługi z komputera klienckiego przy użyciu przeglądarki.

    Jeśli usługa jest hostowana samodzielnie:

    1. Na maszynie usługi utwórz katalog do przechowywania plików usługi.

    2. Skopiuj pliki programu usługi z folderu \service\bin\ w folderze specyficznym dla języka na maszynę usługi.

    3. W pliku konfiguracji usługi zmień wartość adresu definicji punktu końcowego, aby odpowiadała nowemu adresowi usługi. Zastąp wszystkie odwołania do "localhost" w pełni kwalifikowaną nazwą domeny w adresie.

    4. Uruchom Service.exe z wiersza polecenia.

  2. Skopiuj pliki programu klienckiego z folderu \client\bin\ w folderze specyficznym dla języka do komputera klienckiego.

  3. Ustaw adres punktu końcowego.

    1. Jeśli usługa nie jest uruchomiona na koncie domeny, otwórz plik konfiguracji klienta i zmień wartość adresu definicji punktu końcowego, aby dopasować go do nowego adresu usługi. Zastąp wszystkie odwołania do "localhost" w pełni kwalifikowaną nazwą domeny w adresie.

    2. Jeśli usługa jest uruchomiona na koncie domeny, ponownie wygeneruj konfigurację klienta, uruchamiając Svcutil.exe względem usługi. Aby uzyskać więcej informacji na temat uruchamiania Svcutil.exe, zobacz Tworzenie przykładów programu Windows Communication Foundation. Użyj wygenerowanego pliku zamiast pliku konfiguracji w przykładzie. Wygenerowany plik konfiguracji zawiera dodatkowe informacje o tożsamości i zawiera wszystkie ustawienia niezbędne do nawiązania połączenia z punktem końcowym usługi, mimo że są to ustawienia domyślne. Aby uzyskać więcej informacji na temat tożsamości, zobacz Tożsamość i uwierzytelnianie usługi oraz <tożsamość>.

  4. Na komputerze klienckim uruchom Client.exe z wiersza polecenia.

Aby debugować usługę

  1. Skompiluj rozwiązanie (zarówno klienta, jak i usługę) przy użyciu menu Kompilacja lub Ctrl+Shift+B.

  2. Jeśli usługa jest hostowana w usługach IIS:

    1. Aktywuj usługę przy użyciu przeglądarki, wprowadzając adres http://localhost/servicemodelsamples/service.svc.

    2. W rozwiązaniu wybierz menu Debugowanie i element menu Dołączanie do procesu .

    3. Zaznacz pole wyboru Pokaż procesy od wszystkich użytkowników.

    4. Wybierz proces roboczy hosta W3wp.exe do debugowania (wybierz pozycję ASPNet_wp.exe w systemie Windows XP).

  3. Teraz można ustawić punkty przerwania w kodzie usługi i włączyć punkty przerwania dla wyjątków.

  4. Kliknij prawym przyciskiem myszy element projektu klienta i wybierz polecenie Debuguj, Uruchom nowe wystąpienie.

Aby wyczyścić po próbce

  • Jeśli usługa jest hostowana w usługach IIS do celów zabezpieczeń, usuń definicję katalogu wirtualnego i uprawnienia przyznane w krokach konfiguracji po zakończeniu pracy z przykładami.

Zobacz też