Een WCF-gegevensservicereferentie toevoegen, bijwerken of verwijderen

Voor .NET Framework-projecten biedt servicereferenties een project toegang tot een of meer WCF-gegevensservices. Gebruik het dialoogvenster Servicereferentie toevoegen om te zoeken naar WCF-gegevensservices in de huidige oplossing, lokaal, op een lokaal netwerk of op internet.

Voor .NET Core-projecten kunt u het knooppunt Connected Services in Solution Explorer gebruiken voor toegang tot de Microsoft WCF-webserviceverwijzingsprovider, waarmee u WCF-gegevensserviceverwijzingen (Windows Communication Foundation) kunt beheren.

Vereiste voorwaarden

De WCF-hulpprogramma's worden niet geïnstalleerd met de .NET-werkbelasting; gebruik het Installatieprogramma van Visual Studio om uw installatie te wijzigen. Kies in het installatieprogramma Windows Communication Foundation onder Afzonderlijke onderdelen. Zie Visual Studio wijzigen.

Een WCF-servicereferentie toevoegen

Een verwijzing toevoegen naar een externe service (.NET Framework-projecten)

1. Klik in Solution Explorer met de rechtermuisknop op de naam van het project waaraan u de service wilt toevoegen en selecteer vervolgens Serviceverwijzing toevoegen.

   Het dialoogvenster Servicereferentie toevoegen wordt weergegeven.

2. Voer in het vak Adres de URL voor de service in en selecteer Vervolgens Ga om naar de service te zoeken. Als de service gebruikersnaam- en wachtwoordbeveiliging implementeert, wordt u mogelijk gevraagd om een gebruikersnaam en wachtwoord. U kunt ook een service kiezen in uw eigen oplossing. Kies de knop Ontdekken en kies vervolgens Services in Oplossing.

   Opmerking

   U moet alleen verwijzen naar services van een vertrouwde bron. Het toevoegen van verwijzingen van een niet-vertrouwde bron kan de beveiliging in gevaar komen.

   U kunt de URL ook selecteren uit de URL-lijst, waarin de vorige 15 URL's worden opgeslagen waarop geldige servicemetagegevens zijn gevonden.

   Er wordt een voortgangsbalk weergegeven wanneer de zoekopdracht wordt uitgevoerd. U kunt de zoekopdracht op elk gewenst moment stoppen door op Stoppen te klikken.

3. Vouw in de lijst Services het knooppunt uit voor de service die u wilt gebruiken en selecteer een entiteitsset.

4. Voer in het vak Naamruimte de naamruimte in die u wilt gebruiken voor de verwijzing.

5. Klik op OK om de verwijzing naar het project toe te voegen.

   Er wordt een serviceclient (proxy) gegenereerd en metagegevens die de service beschrijven, worden toegevoegd aan het app.config-bestand .

Een verwijzing toevoegen naar een externe service (.NET Core-projecten, inclusief .NET 5 en hoger)

1. Dubbelklik of tik in Solution Explorer op het knooppunt Connected Services .

   Het tabblad Services configureren wordt geopend.

2. Kies Microsoft WCF-webserviceverwijzingsprovider.

   Het dialoogvenster Configureer WCF-webservicereferentie wordt weergegeven.

   

3. Voer in het vak URI de URL voor de service in en selecteer Vervolgens Ga om naar de service te zoeken. Als de service gebruikersnaam- en wachtwoordbeveiliging implementeert, wordt u mogelijk gevraagd om een gebruikersnaam en wachtwoord.

   Opmerking

   U moet alleen verwijzen naar services van een vertrouwde bron. Het toevoegen van verwijzingen van een niet-vertrouwde bron kan de beveiliging in gevaar komen.

   U kunt ook de URL selecteren in de URI-lijst , waarin de vorige 15 URL's worden opgeslagen waarop geldige servicemetagegevens zijn gevonden.

   Er wordt een voortgangsbalk weergegeven wanneer de zoekopdracht wordt uitgevoerd. U kunt de zoekopdracht op elk gewenst moment stoppen door op Stoppen te klikken.

4. Vouw in de lijst Services het knooppunt uit voor de service die u wilt gebruiken en selecteer een entiteitsset.

5. Voer in het vak Naamruimte de naamruimte in die u wilt gebruiken voor de verwijzing.

6. Klik op Voltooien om de verwijzing naar het project toe te voegen.

   Er wordt een serviceclient (proxy) gegenereerd en metagegevens die de service beschrijven, worden toegevoegd aan het app.config-bestand .

Een verwijzing naar een service toevoegen in de huidige oplossing (.NET Framework-projecten)

1. Klik in Solution Explorer met de rechtermuisknop op de naam van het project waaraan u de service wilt toevoegen en selecteer vervolgens Serviceverwijzing toevoegen.

   Het dialoogvenster Servicereferentie toevoegen wordt weergegeven.

2. Klik op Ontdekken.

   Alle services (zowel WCF Data Services als WCF-services) in de huidige oplossing worden toegevoegd aan de lijst Services .

3. Vouw in de lijst Services het knooppunt uit voor de service die u wilt gebruiken en selecteer een entiteitsset.

4. Voer in het vak Naamruimte de naamruimte in die u wilt gebruiken voor de verwijzing.

5. Klik op OK om de verwijzing naar het project toe te voegen.

   Een serviceclient (proxy) genereert en metagegevens die de service beschrijven, worden toegevoegd aan het app.config-bestand .

Een verwijzing naar een service toevoegen in de huidige oplossing (.NET Core-projecten)

1. Dubbelklik of tik in Solution Explorer op het knooppunt Connected Services .

   Het tabblad Services configureren wordt geopend.

2. Kies Microsoft WCF-webserviceverwijzingsprovider.

   Het dialoogvenster Configureer WCF-webservicereferentie wordt weergegeven.

3. Klik op Ontdekken.

   Alle services (zowel WCF Data Services als WCF-services) in de huidige oplossing worden toegevoegd aan de lijst Services .

4. Vouw in de lijst Services het knooppunt uit voor de service die u wilt gebruiken en selecteer een entiteitsset.

5. Voer in het vak Naamruimte de naamruimte in die u wilt gebruiken voor de verwijzing.

6. Klik op Voltooien om de verwijzing naar het project toe te voegen.

   Een serviceclient (proxy) genereert en metagegevens die de service beschrijven, worden toegevoegd aan het app.config-bestand .

Een servicereferentie bijwerken

Het entiteitsgegevensmodel voor een WCF-gegevensservices verandert soms. Als dit gebeurt, moet u de servicereferentie bijwerken.

Een servicereferentie bijwerken

Een servicereferentie verwijderen

Als een servicereferentie niet meer wordt gebruikt, kunt u deze verwijderen uit uw oplossing.

Een verwijzing naar een service verwijderen

• Klik in Solution Explorer met de rechtermuisknop op de serviceverwijzing en selecteer Vervolgens Verwijderen.

  De serviceclient wordt verwijderd uit de oplossing en de metagegevens die de service beschrijven, worden verwijderd uit het app.config-bestand .

  Opmerking

  Code die verwijst naar de serviceverwijzing, moet handmatig worden verwijderd.

Verwante inhoud

• Windows Communication Foundation Services en WCF-gegevensservices in Visual Studio