Dodawanie, aktualizowanie lub usuwanie odwołania do usługi danych WCF

W przypadku projektów programu .NET Framework dokumentacja usługi umożliwia projektowi uzyskiwanie dostępu do co najmniej jednego Usługi danych programu WCF. Użyj okna dialogowego Dodawanie odwołania do usługi, aby wyszukać Usługi danych programu WCF w bieżącym rozwiązaniu, lokalnie, w sieci lokalnej lub w Internecie.

W przypadku projektów platformy .NET Core można użyć węzła Usługi połączone w Eksplorator rozwiązań, aby uzyskać dostęp do dostawcy dokumentacji usług sieci Web programu Microsoft WCF, który umożliwia zarządzanie odwołaniami do usługi danych programu Windows Communication Foundation (WCF).

Uwaga

Na komputerze mogą być wyświetlane różne nazwy lub lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio w tym artykule. Być może używasz innej wersji programu Visual Studio lub innych ustawień środowiska. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE.

Wymagania wstępne

Narzędzia WCF nie są instalowane z obciążeniem platformy .NET; użyj Instalator programu Visual Studio, aby zmodyfikować instalację. W instalatorze wybierz pozycję Windows Communication Foundation w obszarze Poszczególne składniki. Zobacz Modyfikowanie programu Visual Studio.

Dodawanie dokumentacji usługi WCF

Aby dodać odwołanie do usługi zewnętrznej (projekty .NET Framework)

1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy nazwę projektu, do którego chcesz dodać usługę, a następnie wybierz pozycję Dodaj odwołanie do usługi.

   Zostanie wyświetlone okno dialogowe Dodawanie odwołania do usługi.

2. W polu Adres wprowadź adres URL usługi, a następnie wybierz pozycję Przejdź , aby wyszukać usługę. Jeśli usługa implementuje nazwę użytkownika i zabezpieczenia hasła, może zostać wyświetlony monit o podanie nazwy użytkownika i hasła. Możesz również wybrać usługę we własnym rozwiązaniu. Wybierz przycisk Odnajdź, a następnie wybierz pozycję Usługi w rozwiązaniu.

   Uwaga

   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.

   Możesz również wybrać adres URL z listy Adres , która przechowuje poprzednie 15 adresów URL, w których znaleziono prawidłowe metadane usługi.

   Pasek postępu jest wyświetlany po wykonaniu wyszukiwania. Wyszukiwanie można zatrzymać w dowolnym momencie, klikając pozycję Zatrzymaj.

3. Na liście Usługi rozwiń węzeł dla usługi, której chcesz użyć, i wybierz zestaw jednostek.

4. W polu Przestrzeń nazw wprowadź przestrzeń nazw, której chcesz użyć dla odwołania.

5. Kliknij przycisk OK , aby dodać odwołanie do projektu.

   Klient usługi (serwer proxy) jest generowany, a metadane opisujące usługę są dodawane do pliku app.config .

Aby dodać odwołanie do usługi zewnętrznej (projekty .NET Core, w tym .NET 5 i nowsze)

1. W Eksplorator rozwiązań kliknij dwukrotnie lub naciśnij węzeł Usługi połączone.

   Zostanie otwarta karta Konfigurowanie usług .

2. Wybierz pozycję Microsoft WCF Web Service Reference Provider (Dostawca odwołań do usług sieci Web programu Microsoft WCF).

   Zostanie wyświetlone okno dialogowe Konfigurowanie dokumentacji usługi sieci Web programu WCF.

   

3. W polu Identyfikator URI wprowadź adres URL usługi, a następnie wybierz pozycję Przejdź, aby wyszukać usługę. Jeśli usługa implementuje nazwę użytkownika i zabezpieczenia hasła, może zostać wyświetlony monit o podanie nazwy użytkownika i hasła.

   Uwaga

   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.

   Możesz również wybrać adres URL z listy identyfikatorów URI , która przechowuje poprzednie 15 adresów URL, w których znaleziono prawidłowe metadane usługi.

   Pasek postępu jest wyświetlany po wykonaniu wyszukiwania. Wyszukiwanie można zatrzymać w dowolnym momencie, klikając pozycję Zatrzymaj.

4. Na liście Usługi rozwiń węzeł dla usługi, której chcesz użyć, i wybierz zestaw jednostek.

5. W polu Przestrzeń nazw wprowadź przestrzeń nazw, której chcesz użyć dla odwołania.

6. Kliknij przycisk Zakończ , aby dodać odwołanie do projektu.

   Klient usługi (serwer proxy) jest generowany, a metadane opisujące usługę są dodawane do pliku app.config .

Aby dodać odwołanie do usługi w bieżącym rozwiązaniu (projekty .NET Framework)

1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy nazwę projektu, do którego chcesz dodać usługę, a następnie wybierz pozycję Dodaj odwołanie do usługi.

   Zostanie wyświetlone okno dialogowe Dodawanie odwołania do usługi.

2. Kliknij pozycję Odnajdź.

   Wszystkie usługi (zarówno Usługi danych programu WCF, jak i WCF) w bieżącym rozwiązaniu są dodawane do listy Usługi.

3. Na liście Usługi rozwiń węzeł dla usługi, której chcesz użyć, i wybierz zestaw jednostek.

4. W polu Przestrzeń nazw wprowadź przestrzeń nazw, której chcesz użyć dla odwołania.

5. Kliknij przycisk OK , aby dodać odwołanie do projektu.

   Klient usługi (proxy) generuje i metadane opisujące usługę są dodawane do pliku app.config .

Aby dodać odwołanie do usługi w bieżącym rozwiązaniu (projekty .NET Core)

1. W Eksplorator rozwiązań kliknij dwukrotnie lub naciśnij węzeł Usługi połączone.

   Zostanie otwarta karta Konfigurowanie usług .

2. Wybierz pozycję Microsoft WCF Web Service Reference Provider (Dostawca odwołań do usług sieci Web programu Microsoft WCF).

   Zostanie wyświetlone okno dialogowe Konfigurowanie dokumentacji usługi sieci Web programu WCF.

3. Kliknij pozycję Odnajdź.

   Wszystkie usługi (zarówno Usługi danych programu WCF, jak i WCF) w bieżącym rozwiązaniu są dodawane do listy Usługi.

4. Na liście Usługi rozwiń węzeł dla usługi, której chcesz użyć, i wybierz zestaw jednostek.

5. W polu Przestrzeń nazw wprowadź przestrzeń nazw, której chcesz użyć dla odwołania.

6. Kliknij przycisk Zakończ , aby dodać odwołanie do projektu.

   Klient usługi (proxy) generuje i metadane opisujące usługę są dodawane do pliku app.config .

Aktualizowanie odwołania do usługi

Model danych jednostki dla Usługi danych programu WCF czasami się zmienia. W takim przypadku należy zaktualizować odwołanie do usługi.

Aby zaktualizować odwołanie do usługi

W przypadku projektów platformy .NET Core użyj dotnet-svcutil narzędzia . Aby uzyskać instrukcje i instalację, zobacz dotnet-svcutil .

W przypadku projektów .NET Framework:

• W Eksplorator rozwiązań rozwiń węzeł Usługi połączone, kliknij prawym przyciskiem myszy odwołanie do usługi, a następnie wybierz pozycję Aktualizuj odwołanie do usługi.

  Okno dialogowe postępu jest wyświetlane, gdy odwołanie jest aktualizowane z oryginalnej lokalizacji, a klient usługi jest ponownie wygenerowany w celu odzwierciedlenia wszelkich zmian w metadanych.

Usuwanie odwołania do usługi

Jeśli odwołanie do usługi nie jest już używane, możesz usunąć go z rozwiązania.

Aby usunąć odwołanie do usługi

• W Eksplorator rozwiązań kliknij prawym przyciskiem myszy odwołanie do usługi, a następnie wybierz polecenie Usuń.

  Klient usługi zostanie usunięty z rozwiązania, a metadane opisujące usługę zostaną usunięte z pliku app.config .

  Uwaga

  Każdy kod, który odwołuje się do odwołania do usługi, należy usunąć ręcznie.

Powiązana zawartość

• Usługi Windows Communication Foundation Services i usługi danych WCF w programie Visual Studio