Sdílet prostřednictvím

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

  • Článek

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

Pro projekty .NET Core můžete pomocí uzlu Připojené služby v Průzkumník řešení získat přístup k zprostředkovateli 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 pro Visual Studio. V instalačním programu zvolte v části Jednotlivé součásti službu Windows Communication Foundation . Viz Úprava 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ík ř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 zvolit také 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 Namespace zadejte obor názvů, který chcete použít pro odkaz.

  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 souboru app.config .

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

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

    Otevře se karta Konfigurovat služby .

  2. Zvolte zprostředkovatele odkazů webových služeb Microsoft WCF.

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

    Snímek obrazovky s dialogovým oknem zprostředkovatele webových služeb 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 Namespace zadejte obor názvů, který chcete použít pro odkaz.

  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 souboru app.config .

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

  1. V Průzkumník ř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 tlačítko Zjistit.

    Do seznamu Služeb se přidají všechny služby (Datové služby WCF 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 Namespace zadejte obor názvů, který chcete použít pro odkaz.

  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 souboru app.config .

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

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

    Otevře se karta Konfigurovat služby .

  2. Zvolte zprostředkovatele odkazů webových služeb Microsoft WCF.

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

  3. Klikněte na tlačítko Zjistit.

    Do seznamu Služeb se přidají všechny služby (Datové služby WCF 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 Namespace zadejte obor názvů, který chcete použít pro odkaz.

  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 souboru app.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

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

    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.

Pro projekty .NET Core použijte dotnet-svcutil nástroj. Pokyny a instalaci najdete v souboru dotnet-svcutil .

Pro projekty .NET Framework:

  • V Průzkumník ř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.

Odebrání odkazu na službu

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

Odebrání odkazu na službu

  • V Průzkumník ř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 souboru app.config .

    Poznámka:

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

Související obsah