Přidání, aktualizace nebo odebrání odkazu na datovou službu WCF

V případě projektů rozhraní .NET Framework odkaz na službu umožňuje projektu přístup k jedné nebo více datovým službám WCF. Pomocí dialogového okna Přidat odkaz služby vyhledejte datové služby WCF v aktuálním řešení, místně, v místní síti nebo na internetu.

V případě projektů .NET Core můžete pomocí uzlu Připojené služby v Průzkumníku řešení získat přístup k poskytovateli odkazů webové služby Microsoft WCF, který umožňuje spravovat odkazy na datové služby WCF (Windows Communication Foundation).

Poznámka:

V počítači se můžou zobrazovat různé názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio v tomto článku. Možná používáte jinou edici sady Visual Studio nebo jiné nastavení prostředí. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí (IDE).

Požadavky

Nástroje WCF nejsou nainstalovány s úlohou .NET; k úpravě instalace použijte Instalační program sady Visual Studio. V instalačním programu zvolte v části Jednotlivé součásti službu Windows Communication Foundation . Podívejte se na Úpravy sady Visual Studio.

Přidání odkazu na službu WCF

Přidání odkazu na externí službu (projekty .NET Framework)

1. V Průzkumníku řešení klikněte pravým tlačítkem myši na název projektu, do kterého chcete přidat službu, a pak vyberte Přidat odkaz na službu.

   Zobrazí se dialogové okno Přidat odkaz na službu .

2. Do pole Adresa zadejte adresu URL služby a pak vyberte Přejít a vyhledejte službu. Pokud služba implementuje zabezpečení uživatelského jména a hesla, může se zobrazit výzva k zadání uživatelského jména a hesla. Službu můžete také zvolit ve vlastním řešení. Zvolte tlačítko Zjistit a pak zvolte Služby v řešení.

   Poznámka:

   Měli byste odkazovat pouze na služby z důvěryhodného zdroje. Přidání odkazů z nedůvěryhodného zdroje může ohrozit zabezpečení.

   Můžete také vybrat adresu URL ze seznamu adres , ve které jsou uloženy předchozí 15 adres URL, na kterých byla nalezena platná metadata služby.

   Při provedení hledání se zobrazí indikátor průběhu. Vyhledávání můžete kdykoli zastavit kliknutím na Zastavit.

3. V seznamu Služby rozbalte uzel pro službu, kterou chcete použít, a vyberte sadu entit.

4. Do pole Obor názvů zadejte obor názvů, který chcete použít pro referenci.

5. Kliknutím na tlačítko OK přidáte odkaz na projekt.

   Vygeneruje se klient služby (proxy) a metadata popisovaná službou se přidají do app.config souboru.

Přidání odkazu na externí službu (projekty .NET Core, včetně .NET 5 a novějších)

1. V Průzkumníku řešení poklikejte nebo klepněte na uzel Připojené služby .

   Otevře se karta Konfigurovat služby .

2. Zvolte poskytovatele referencí webových služeb Microsoft WCF.

   Zobrazí se dialogové okno Konfigurovat odkaz na webovou službu WCF .

   

3. Do pole identifikátoru URI zadejte adresu URL služby a pak vyberte Přejít a vyhledejte službu. Pokud služba implementuje zabezpečení uživatelského jména a hesla, může se zobrazit výzva k zadání uživatelského jména a hesla.

   Poznámka:

   Měli byste odkazovat pouze na služby z důvěryhodného zdroje. Přidání odkazů z nedůvěryhodného zdroje může ohrozit zabezpečení.

   Můžete také vybrat adresu URL ze seznamu identifikátorů URI , ve které jsou uloženy předchozí 15 adres URL, na kterých byla nalezena platná metadata služby.

   Při provedení hledání se zobrazí indikátor průběhu. Vyhledávání můžete kdykoli zastavit kliknutím na Zastavit.

4. V seznamu Služby rozbalte uzel pro službu, kterou chcete použít, a vyberte sadu entit.

5. Do pole Obor názvů zadejte obor názvů, který chcete použít pro referenci.

6. Kliknutím na tlačítko Dokončit přidáte odkaz na projekt.

   Vygeneruje se klient služby (proxy) a metadata popisovaná službou se přidají do app.config souboru.

Přidání odkazu na službu v aktuálním řešení (projekty .NET Framework)

1. V Průzkumníku řešení klikněte pravým tlačítkem myši na název projektu, do kterého chcete přidat službu, a pak vyberte Přidat odkaz na službu.

   Zobrazí se dialogové okno Přidat odkaz na službu .

2. Klikněte na Zjistit.

   Do seznamu Služeb se přidají všechny služby (služby WCF Data Services i služby WCF) v aktuálním řešení.

3. V seznamu Služby rozbalte uzel pro službu, kterou chcete použít, a vyberte sadu entit.

4. Do pole Obor názvů zadejte obor názvů, který chcete použít pro referenci.

5. Kliknutím na tlačítko OK přidáte odkaz na projekt.

   Klient služby (proxy) vygeneruje a metadata popisovaná službou se přidají do souboruapp.config .

Přidání odkazu na službu v aktuálním řešení (projekty .NET Core)

1. V Průzkumníku řešení poklikejte nebo klepněte na uzel Připojené služby .

   Otevře se karta Konfigurovat služby .

2. Zvolte poskytovatele referencí webových služeb Microsoft WCF.

   Zobrazí se dialogové okno Konfigurovat odkaz na webovou službu WCF .

3. Klikněte na Zjistit.

   Do seznamu Služeb se přidají všechny služby (služby WCF Data Services i služby WCF) v aktuálním řešení.

4. V seznamu Služby rozbalte uzel pro službu, kterou chcete použít, a vyberte sadu entit.

5. Do pole Obor názvů zadejte obor názvů, který chcete použít pro referenci.

6. Kliknutím na tlačítko Dokončit přidáte odkaz na projekt.

   Klient služby (proxy) vygeneruje a metadata popisovaná službou se přidají do souboruapp.config .

Aktualizace odkazu na službu

Datový model entity pro datové služby WCF se někdy změní. V takovém případě je nutné aktualizovat odkaz na službu.

Aktualizace odkazu na službu

Pro projekty .NET Core použijte dotnet-svcutil nástroj. Instalaci a pokyny najdete v dotnet-svcutil.

Pro projekty .NET Framework:

• V Průzkumníku řešení rozbalte uzel Připojené služby , klikněte pravým tlačítkem myši na odkaz na službu a pak vyberte Aktualizovat odkaz na službu.

  Při aktualizaci odkazu z původního umístění se zobrazí dialogové okno průběhu a klient služby se znovu vygeneruje, aby odrážel všechny změny v metadatech.

Odebrat odkaz na službu

Pokud už odkaz na službu nepoužíváte, můžete ho z řešení odebrat.

Odstranit odkaz na službu

• V Průzkumníku řešení klikněte pravým tlačítkem myši na odkaz služby a pak vyberte Odstranit.

  Klient služby se z řešení odebere a metadata popisovaná službou se odeberou ze souboruapp.config .

  Poznámka:

  Veškerý kód, který odkazuje na odkaz na službu, musí být odebrán ručně.

Související obsah

• Služby Windows Communication Foundation a datové služby WCF v prostředí sady Visual Studio