Lägga till, uppdatera eller ta bort en WCF-datatjänstreferens

För .NET Framework-projekt gör tjänstreferens att ett projekt kan komma åt en eller flera WCF Data Services. Använd dialogrutan Lägg till tjänstreferens för att söka efter WCF Data Services i den aktuella lösningen, lokalt, i ett lokalt nätverk eller på Internet.

För .NET Core-projekt kan du använda noden Anslutna tjänster i Solution Explorer för att få åtkomst till Microsoft WCF Web Service Reference Provider, som gör att du kan hantera windows Communication Foundation-datatjänstreferenser (WCF).

Förutsättningar

WCF-verktygen installeras inte med .NET-arbetsbelastningen. använd Visual Studio Installer för att ändra installationen. I installationsprogrammet väljer du Windows Communication Foundation under Enskilda komponenter. Se Ändrai Visual Studio.

Lägga till en WCF-tjänstreferens

Så här lägger du till en referens till en extern tjänst (.NET Framework-projekt)

1. Högerklicka på namnet på det projekt som du vill lägga till tjänsten till i Solution Explorer och välj sedan Lägg till tjänstreferens.

   Dialogrutan Lägg till tjänstreferens visas.

2. I rutan Adress anger du URL:en för tjänsten och väljer sedan Gå för att söka efter tjänsten. Om tjänsten implementerar användarnamn och lösenordssäkerhet kan du uppmanas att ange ett användarnamn och lösenord. Du kan också välja en tjänst i din egen lösning. Välj knappen Identifiera och välj sedan Tjänster i lösningen.

   Anmärkning

   Du bör bara referera till tjänster från en betrodd källa. Att lägga till referenser från en ej betrodd källa kan äventyra säkerheten.

   Du kan också välja URL:en från adresslistan , som lagrar de tidigare 15 URL:er där giltiga tjänstmetadata hittades.

   Ett förloppsfält visas när sökningen utförs. Du kan avbryta sökningen när som helst genom att klicka på Stoppa.

3. I listan Tjänster expanderar du noden för den tjänst som du vill använda och väljer en entitetsuppsättning.

4. I rutan Namnområde anger du det namnområde som du vill använda för referensen.

5. Klicka på OK för att lägga till referensen till projektet.

   En tjänstklient (proxy) genereras och metadata som beskriver tjänsten läggs till i filenapp.config .

Så här lägger du till en referens till en extern tjänst (.NET Core-projekt, inklusive .NET 5 och senare)

1. Dubbelklicka eller tryck på noden Anslutna tjänster i Solution Explorer.

   Fliken Konfigurera tjänster öppnas.

2. Välj Microsoft WCF-webbtjänstreferensprovider.

   Dialogrutan Konfigurera WCF-webbtjänstreferens visas.

   

3. I rutan URI anger du URL:en för tjänsten och väljer sedan Gå för att söka efter tjänsten. Om tjänsten implementerar användarnamn och lösenordssäkerhet kan du uppmanas att ange ett användarnamn och lösenord.

   Anmärkning

   Du bör bara referera till tjänster från en betrodd källa. Att lägga till referenser från en ej betrodd källa kan äventyra säkerheten.

   Du kan också välja URL:en från URI-listan , som lagrar de tidigare 15 URL:er där giltiga tjänstmetadata hittades.

   Ett förloppsfält visas när sökningen utförs. Du kan avbryta sökningen när som helst genom att klicka på Stoppa.

4. I listan Tjänster expanderar du noden för den tjänst som du vill använda och väljer en entitetsuppsättning.

5. I rutan Namnområde anger du det namnområde som du vill använda för referensen.

6. Klicka på Slutför för att lägga till referensen till projektet.

   En tjänstklient (proxy) genereras och metadata som beskriver tjänsten läggs till i filenapp.config .

Så här lägger du till en referens till en tjänst i den aktuella lösningen (.NET Framework-projekt)

1. Högerklicka på namnet på det projekt som du vill lägga till tjänsten till i Solution Explorer och välj sedan Lägg till tjänstreferens.

   Dialogrutan Lägg till tjänstreferens visas.

2. Klicka på Identifiera.

   Alla tjänster (både WCF Data Services och WCF-tjänster) i den aktuella lösningen läggs till i listan Tjänster .

3. I listan Tjänster expanderar du noden för den tjänst som du vill använda och väljer en entitetsuppsättning.

4. I rutan Namnområde anger du det namnområde som du vill använda för referensen.

5. Klicka på OK för att lägga till referensen till projektet.

   En tjänstklient (proxy) genererar och metadata som beskriver tjänsten läggs till i app.config-filen .

Så här lägger du till en referens till en tjänst i den aktuella lösningen (.NET Core-projekt)

1. Dubbelklicka eller tryck på noden Anslutna tjänster i Solution Explorer.

   Fliken Konfigurera tjänster öppnas.

2. Välj Microsoft WCF-webbtjänstreferensprovider.

   Dialogrutan Konfigurera WCF-webbtjänstreferens visas.

3. Klicka på Identifiera.

   Alla tjänster (både WCF Data Services och WCF-tjänster) i den aktuella lösningen läggs till i listan Tjänster .

4. I listan Tjänster expanderar du noden för den tjänst som du vill använda och väljer en entitetsuppsättning.

5. I rutan Namnområde anger du det namnområde som du vill använda för referensen.

6. Klicka på Slutför för att lägga till referensen till projektet.

   En tjänstklient (proxy) genererar och metadata som beskriver tjänsten läggs till i app.config-filen .

Uppdatera en tjänstreferens

Entitetsdatamodellen för en WCF Data Services ändras ibland. När detta händer måste du uppdatera tjänstreferensen.

Uppdatera en tjänstreferens

Ta bort en tjänstreferens

Om en tjänstreferens inte längre används kan du ta bort den från lösningen.

Ta bort en tjänstreferens

• Högerklicka på tjänstreferensen i Solution Explorer och välj sedan Ta bort.

  Tjänstklienten tas bort från lösningen och metadata som beskriver tjänsten tas bort från app.config-filen .

  Anmärkning

  All kod som refererar till tjänstreferensen måste tas bort manuellt.

Relaterat innehåll

• Windows Communication Foundation Services och WCF-datatjänster i Visual Studio