Udostępnij za pośrednictwem

Korzystanie z narzędzia dostawcy referencyjnego usług sieci Web WCF

  • Artykuł

W ciągu ostatnich lat wielu deweloperów programu Visual Studio cieszyło się produktywnością, jaką narzędzie Dodaj odwołanie do usług zapewniało, gdy ich projekty programu .NET Framework potrzebne do uzyskiwania dostępu do usług internetowych.

Narzędzie dokumentacji usługi sieci Web WCF to rozszerzenie połączonej usługi programu Visual Studio, które umożliwia łączenie projektu .NET 5+, .NET Core lub ASP.NET Core z usługą internetową. Zapewnia środowisko podobne do funkcji Dodawanie odwołania do usługi, która jest dostępna tylko dla projektów programu .NET Framework. Narzędzie do dokumentacji usługi sieci Web programu WCF pobiera metadane z usługi internetowej w bieżącym rozwiązaniu, w lokalizacji sieciowej lub z pliku WSDL i generuje plik źródłowy zawierający kod serwera proxy klienta programu Windows Communication Foundation (WCF), którego aplikacja .NET może używać do uzyskiwania dostępu do usługi internetowej.

Ważne

Należy odwoływać się tylko do usług z zaufanego źródła. Dodanie odwołań z niezaufanego źródła może naruszyć bezpieczeństwo.

Wymagania wstępne

Zrzuty ekranu w tym artykule pochodzą z programu Visual Studio 2022.

Jak używać rozszerzenia

Uwaga

Narzędzie dokumentacji usługi sieci Web programu WCF ma zastosowanie tylko do projektów C# .NET Core i .NET Standard, w tym ASP.NET Core Web Apps.

Korzystając z szablonu projektu ASP.NET Core Web Application jako przykładu, ten artykuł przeprowadzi Cię przez proces dodawania odwołania do usługi WCF do projektu.

  1. W Eksplorator rozwiązań kliknij dwukrotnie węzeł usługi Połączenie projektu. (W przypadku projektu .NET Core lub .NET Standard kliknij prawym przyciskiem myszy projekt i wybierz polecenie Dodaj> usługę Połączenie ed).

    Zostanie wyświetlona strona Połączenie Usług, jak pokazano na poniższej ilustracji:

    Visual Studio Connected Services tab for .NET Core

  2. Na stronie usługi Połączenie wybierz pozycję Dodaj odwołanie do usługi.

    Zostanie otwarta strona Dodawanie odwołania do usługi.

  3. Wybierz pozycję Usługa sieci Web programu WCF, a następnie wybierz pozycję Dalej.

    Spowoduje to wyświetlenie kreatora dodawania nowej usługi sieci Web WCF.

    Visual Studio Service Endpoint tab for .NET Core

  4. Wybierz usługę.

    a. Dostępnych jest kilka opcji wyszukiwania usług:

    • Aby wyszukać usługi zdefiniowane w bieżącym rozwiązaniu , kliknij przycisk Odnajdź .
    • Aby wyszukać usługi hostowane pod określonym adresem, wprowadź adres URL usługi w polu Adres i kliknij przycisk Przejdź .
    • Aby wybrać plik WSDL zawierający informacje o metadanych usługi internetowej, kliknij przycisk Przeglądaj .

    b. Wybierz usługę z listy wyników wyszukiwania w polu Usługi . W razie potrzeby wprowadź przestrzeń nazw dla wygenerowanego kodu w odpowiednim polu tekstowym Przestrzeń nazw .

    c. Kliknij przycisk Dalej, aby określić opcje typu danych lub opcje klienta. Alternatywnie kliknij przycisk Zakończ , aby użyć opcji domyślnych.

  5. Strona opcji typu danych umożliwia uściślinie wygenerowanych ustawień konfiguracji dokumentacji usługi:

    Visual Studio Data type options tab for .NET Core

    Uwaga

    Opcja wyboru Ponowne używanie typów w zestawach , do których odwołuje się odwołanie, jest przydatna, gdy typy danych potrzebne do generowania kodu referencyjnego usługi są zdefiniowane w jednym z zestawów, do których odwołuje się projekt. Ważne jest, aby ponownie użyć tych istniejących typów danych, aby uniknąć konfliktów typu kompilacji lub problemów ze środowiskiem uruchomieniowym.

    Może wystąpić opóźnienie podczas ładowania informacji o typie, w zależności od liczby zależności projektu i innych czynników wydajności systemu. Przycisk Zakończ jest wyłączony podczas ładowania, chyba że pole wyboru Ponownie użyj typów w zestawach, do których odwołuje się odwołanie, nie jest zaznaczone.

  6. Po zakończeniu kliknij przycisk Zakończ .

Podczas wyświetlania postępu narzędzie:

  • Pobiera metadane z usługi WCF.
  • Generuje kod referencyjny usługi w pliku o nazwie reference.cs i dodaje go do projektu w węźle usługi Połączenie.
  • Aktualizacje pliku projektu (csproj) z odwołaniami pakietu NuGet wymaganymi do skompilowania i uruchomienia na platformie docelowej.

Visual Studio Progress window

Po zakończeniu tych procesów można utworzyć wystąpienie wygenerowanego typu klienta WCF i wywołać operacje usługi.

Zobacz też

Opinie i pytania

Jeśli masz jakiekolwiek opinie o produkcie, zgłoś go w społeczności deweloperów przy użyciu narzędzia Zgłoś problem .

Informacje o wersji

  • Zapoznaj się z informacjami o wersji, aby uzyskać zaktualizowane informacje o wersji, w tym znane problemy.