WCF-adatszolgáltatási referencia hozzáadása, frissítése vagy eltávolítása

A .NET-keretrendszer-projektek esetében a szolgáltatáshivatkozás lehetővé teszi a projektek számára egy vagy több WCF Data Services elérését. A Szolgáltatáshivatkozás hozzáadása párbeszédpanel használatával keresse meg a WCF Data Services szolgáltatást az aktuális megoldásban, helyileg, helyi hálózaton vagy az interneten.

.NET Core-projektek esetén a MegoldáskezelőCsatlakoztatott szolgáltatások csomópontjával érheti el a Microsoft WCF webszolgáltatás-referenciaszolgáltatót, amely lehetővé teszi a Windows Communication Foundation (WCF) adatszolgáltatási hivatkozásainak kezelését.

Megjegyzés:

Előfordulhat, hogy a számítógép különböző neveket vagy helyeket jelenít meg a jelen cikkben szereplő Néhány Visual Studio felhasználói felületi elemhez. Előfordulhat, hogy a Visual Studio egy másik kiadását vagy más környezeti beállításokat használ. További információ: Ideszemélyre szabása.

Előfeltételek

A WCF-eszközök nincsenek telepítve a .NET számítási feladattal; a Visual Studio Installer használatával módosíthatja a telepítést. A telepítőben válassza a Windows Communication Foundation lehetőséget az Egyes összetevők területen. Lásd a részt a Visual Studiomódosításáról.

WCF-szolgáltatáshivatkozás hozzáadása

Külső szolgáltatásra (.NET-keretrendszerprojektek) mutató hivatkozás hozzáadása

1. A Megoldáskezelőben kattintson a jobb gombbal annak a projektnek a nevére, amelyhez hozzá szeretné adni a szolgáltatást, majd válassza a Szolgáltatáshivatkozás hozzáadása lehetőséget.

   Megjelenik a Szolgáltatáshivatkozás hozzáadása párbeszédpanel.

2. A Cím mezőbe írja be a szolgáltatás URL-címét, majd válassza az Ugrás lehetőséget a szolgáltatás kereséséhez. Ha a szolgáltatás a felhasználónév és a jelszó biztonságát valósítja meg, előfordulhat, hogy a rendszer felhasználónevet és jelszót kér. A saját megoldásában is választhat szolgáltatást. Válassza a Felfedezés gombot, majd válassza a Megoldás szolgáltatások lehetőséget.

   Megjegyzés:

   Csak megbízható forrásból származó szolgáltatásokra kell hivatkoznia. A nem megbízható forrásból származó hivatkozások hozzáadása veszélyeztetheti a biztonságot.

   A címlistából is kiválaszthatja az URL-címet , amely az előző 15 URL-címet tárolja, amelyeken érvényes szolgáltatás metaadatok találhatók.

   A keresés végrehajtásakor megjelenik egy folyamatjelző sáv. A keresést bármikor leállíthatja a Leállítás gombra kattintva.

3. A Szolgáltatások listában bontsa ki a használni kívánt szolgáltatás csomópontot, és válasszon ki egy entitáskészletet.

4. A Névtér mezőbe írja be a hivatkozáshoz használni kívánt névteret.

5. Kattintson az OK gombra a projektre mutató hivatkozás hozzáadásához.

   Létrejön egy szolgáltatásügyfél (proxy), és a szolgáltatást leíró metaadatok bekerülnek a app.config fájlba.

Külső szolgáltatásra mutató hivatkozás hozzáadása (.NET Core-projektek, beleértve a .NET 5-öt és újabb verziót)

1. A Megoldáskezelőben kattintson vagy koppintson duplán a Csatlakoztatott szolgáltatások csomópontra.

   Megnyílik a Szolgáltatások konfigurálása lap.

2. Válassza a Microsoft WCF webszolgáltatás-referenciaszolgáltatót.

   Megjelenik a WCF webszolgáltatás-referencia konfigurálása párbeszédpanel.

   

3. Az URI mezőbe írja be a szolgáltatás URL-címét, majd válassza az Ugrás lehetőséget a szolgáltatás kereséséhez. Ha a szolgáltatás a felhasználónév és a jelszó biztonságát valósítja meg, előfordulhat, hogy a rendszer felhasználónevet és jelszót kér.

   Megjegyzés:

   Csak megbízható forrásból származó szolgáltatásokra kell hivatkoznia. A nem megbízható forrásból származó hivatkozások hozzáadása veszélyeztetheti a biztonságot.

   Az URL-címet az URI-listából is kiválaszthatja, amely az előző 15 URL-címet tárolja, amelyeken érvényes szolgáltatás metaadatok találhatók.

   A keresés végrehajtásakor megjelenik egy folyamatjelző sáv. A keresést bármikor leállíthatja a Leállítás gombra kattintva.

4. A Szolgáltatások listában bontsa ki a használni kívánt szolgáltatás csomópontot, és válasszon ki egy entitáskészletet.

5. A Névtér mezőbe írja be a hivatkozáshoz használni kívánt névteret.

6. Kattintson a Befejezés gombra a projektre mutató hivatkozás hozzáadásához.

   Létrejön egy szolgáltatásügyfél (proxy), és a szolgáltatást leíró metaadatok bekerülnek a app.config fájlba.

Hivatkozás hozzáadása egy szolgáltatáshoz az aktuális megoldásban (.NET-keretrendszerprojektek)

1. A Megoldáskezelőben kattintson a jobb gombbal annak a projektnek a nevére, amelyhez hozzá szeretné adni a szolgáltatást, majd válassza a Szolgáltatáshivatkozás hozzáadása lehetőséget.

   Megjelenik a Szolgáltatáshivatkozás hozzáadása párbeszédpanel.

2. Kattintson a Felfedezés gombra.

   Az aktuális megoldás összes szolgáltatása (a WCF-adatszolgáltatások és a WCF-szolgáltatások is) felkerül a Szolgáltatások listára.

3. A Szolgáltatások listában bontsa ki a használni kívánt szolgáltatás csomópontot, és válasszon ki egy entitáskészletet.

4. A Névtér mezőbe írja be a hivatkozáshoz használni kívánt névteret.

5. Kattintson az OK gombra a projektre mutató hivatkozás hozzáadásához.

   A szolgáltatásügyfél (proxy) létrehoz és a szolgáltatást leíró metaadatokat hozzáadja a app.config fájlhoz.

Hivatkozás hozzáadása egy szolgáltatáshoz az aktuális megoldásban (.NET Core-projektek)

1. A Megoldáskezelőben kattintson vagy koppintson duplán a Csatlakoztatott szolgáltatások csomópontra.

   Megnyílik a Szolgáltatások konfigurálása lap.

2. Válassza a Microsoft WCF webszolgáltatás-referenciaszolgáltatót.

   Megjelenik a WCF webszolgáltatás-referencia konfigurálása párbeszédpanel.

3. Kattintson a Felfedezés gombra.

   Az aktuális megoldás összes szolgáltatása (a WCF-adatszolgáltatások és a WCF-szolgáltatások is) felkerül a Szolgáltatások listára.

4. A Szolgáltatások listában bontsa ki a használni kívánt szolgáltatás csomópontot, és válasszon ki egy entitáskészletet.

5. A Névtér mezőbe írja be a hivatkozáshoz használni kívánt névteret.

6. Kattintson a Befejezés gombra a projektre mutató hivatkozás hozzáadásához.

   A szolgáltatásügyfél (proxy) létrehoz és a szolgáltatást leíró metaadatokat hozzáadja a app.config fájlhoz.

Szolgáltatáshivatkozás frissítése

A WCF Data Services entitásadat-modellje néha megváltozik. Ha ez történik, frissítenie kell a szolgáltatáshivatkozást.

Szolgáltatáshivatkozás frissítése

.NET Core-projektek esetén használja az dotnet-svcutil eszközt. A telepítésről és az utasításokról a dotnet-svcutil című témakörben olvashat.

.NET-keretrendszer-projektek esetén:

• A Megoldáskezelőben bontsa ki a Csatlakoztatott szolgáltatások csomópontot, kattintson a jobb gombbal a szolgáltatáshivatkozásra, majd válassza a Szolgáltatáshivatkozás frissítése lehetőséget.

  Egy folyamatjelző párbeszédpanel jelenik meg, miközben a hivatkozás az eredeti helyről frissül, és a szolgáltatásügyfél újra létrejön, hogy tükrözze a metaadatok változásait.

Szolgáltatáshivatkozás eltávolítása

Ha már nincs használatban szolgáltatáshivatkozás, eltávolíthatja azt a megoldásból.

Szolgáltatáshivatkozás eltávolítása

• A Megoldáskezelőben kattintson a jobb gombbal a szolgáltatáshivatkozásra, majd válassza a Törlés lehetőséget.

  A szolgáltatásügyfél el lesz távolítva a megoldásból, és a szolgáltatást leíró metaadatok törlődnek a app.config fájlból.

  Megjegyzés:

  A szolgáltatáshivatkozásra hivatkozó kódot manuálisan kell eltávolítani.

Kapcsolódó tartalom

• Windows Communication Foundation Services és WCF-adatszolgáltatások a Visual Studióban