Overzicht: Een WCF-service maken in .NET Framework Windows Forms

In dit scenario ziet u hoe u een WCF-service (Windows Communication Foundation) maakt, test en vervolgens opent vanuit een .NET Framework Windows Forms-toepassing.

Opmerking

De instructies in dit artikel illustreren de meest recente versie van de interactieve ontwikkelervaring (IDE) die beschikbaar is in Visual Studio. Uw computer kan verschillende namen of locaties weergeven voor sommige elementen van de gebruikersinterface. Mogelijk gebruikt u een andere versie van Visual Studio of andere omgevingsinstellingen. Zie De IDE-personaliseren voor meer informatie.

Vereiste voorwaarden

Visual Studio waarop het Windows Communication Foundation-onderdeel is geïnstalleerd. Ga als volgende te werk om het te installeren:

1. Open de Visual Studio Installer-app of selecteer Hulpprogramma's>en functies ophalen in het menu van Visual Studio.
2. Kies In Het installatieprogramma van Visual Studiode optie Wijzigen naast de versie van Visual Studio die u wilt wijzigen.
3. Selecteer het tabblad Afzonderlijke onderdelen en kies vervolgens Windows Communication Foundation onder Ontwikkelingsactiviteiten.
4. Selecteer Wijzigen.

Zie Visual Studio-workloads, onderdelen en taalpakketten wijzigen voor meer informatie.

Een WCF-service maken

Volg deze stappen om een WCF-service te maken in Visual Studio:

1. Selecteer in Visual Studio Bestand>nieuw>project in het menu.

2. Voer op de pagina Een nieuw project makende wcf-servicebibliotheek in het zoekvak in. Selecteer de C#- of Visual Basic-sjabloon voor WCF-servicebibliotheek en selecteer vervolgens Volgende.

   

   Hint

   Als u geen sjablonen ziet, moet u mogelijk het Windows Communication Foundation-onderdeel van Visual Studio installeren. Zie Vereisten voor meer informatie

3. Controleer de instellingen op de pagina Uw nieuwe project configureren en selecteer Maken.

   Met deze stap maakt u een werkende WCF-service die u kunt testen en openen. In de volgende stappen ziet u hoe u de standaardmethode wijzigt om een ander gegevenstype te gebruiken. In een echte toepassing voegt u ook uw eigen functies toe aan de service.

4. Dubbelklik in Solution Explorer op IService1.cs of IService1.vb in uw WCF-servicebibliotheekproject, afhankelijk van het type project dat u hebt gemaakt.

   

5. Zoek de volgende regel:

   C#

   [OperationContract]
   string GetData(int value);
   

   VB

   <OperationContract()>
   Function GetData(ByVal value As Integer) As String
   

---

6. Wijzig het type voor de value parameter naar string.

   Noteer in dit codevoorbeeld het OperationContract kenmerk. Dit kenmerk is vereist voor elke methode die door de service wordt weergegeven.

   C#

   [OperationContract]
   string GetData(string value);
   

   VB

   <OperationContract()>
   Function GetData(ByVal value As String) As String
   

---

7. Dubbelklik in Solution Explorer op Service1.cs of Service1.vb.

   

8. Zoek in de editor de volgende regel:

   C#

   public string GetData(int value)
   {
       return string.Format("You entered: {0}", value);
   }
   

   VB

   Public Function GetData(ByVal value As Integer) As String Implements IService1.GetData
       Return String.Format("You entered: {0}", value)
   End Function
   

---

9. Wijzig het type voor de value-parameter in string, als volgt:

   C#

   public string GetData(string value)
   {
       return string.Format("You entered: {0}", value);
   }
   

   VB

   Public Function GetData(ByVal value As String) As String Implements IService1.GetData
       Return String.Format("You entered: {0}", value)
   End Function
   

---

De WCF-service testen

Voer de volgende stappen uit om de WCF-service te testen die u hebt gemaakt:

1. Druk op F5 om de service uit te voeren.

   Het WCF-testclientformulier wordt weergegeven en laadt de service.

2. Dubbelklik onder IService1 op de methode GetData().

   Het tabblad GetData wordt weergegeven in het wcF-testclientformulier .

   

3. Selecteer in het vak Aanvraag van het tabblad GetData het veld Waarde en voer Hallo in.

   

4. Selecteer de knop Aanroepen . Als het dialoogvenster Beveiligingswaarschuwing wordt weergegeven, selecteert u OK.

   Het resultaat wordt weergegeven in het vak Antwoord .

   

5. Selecteer Afsluiten in het menu Bestand om het testformulier te sluiten.

Toegang tot de WCF-service

Nadat u de WCF-service hebt gemaakt en getest, kunt u ernaar verwijzen vanuit een project en deze gebruiken om een clienttoepassing te bouwen.

Verwijzen naar de WCF-service

Volg deze stappen om te verwijzen naar de WCF-service vanuit een project:

1. Kies Bestand>Toevoegen>Nieuw Project.

2. Kies in het venster Een nieuw project toevoegen het project C# of Visual Basic Windows Forms App (.NET Framework ). Selecteer Volgende en vervolgens Maken om het project te maken.

3. Klik in Solution Explorer met de rechtermuisknop op het projectknooppunt van het nieuwe project en selecteerServiceverwijzing>.

   Het dialoogvenster Servicereferentie toevoegen wordt weergegeven.

4. Selecteer Ontdekken.

   

   Service1 wordt weergegeven in het deelvenster Services .

5. Selecteer OK om de servicereferentie toe te voegen.

Een clienttoepassing bouwen

Als u een WCF-servicereferentie wilt gebruiken om een clienttoepassing te bouwen, volgt u deze stappen.

1. Dubbelklik in Solution Explorer op Form1.cs of Form1.vb in de Windows Forms-app.

   Het formulier wordt geopend in Windows Forms Designer.

2. Open de Toolbox door Weergave>Toolbox te selecteren in het menu, of druk op Ctrl+Alt+X op het toetsenbord.

3. Sleep vanuit de werkset een tekstvakbesturingselement , een labelbesturingselement en een besturingselement Knop naar het formulier.

   

4. Dubbelklik op het besturingselement Knop en voeg de volgende code toe in de Click gebeurtenis-handler:

   C#

   private void button1_Click(System.Object sender, System.EventArgs e)
   {
       ServiceReference1.Service1Client client = new
           ServiceReference1.Service1Client();
       string returnString;
   
       returnString = client.GetData(textBox1.Text);
       label1.Text = returnString;
   }
   

   VB

     Private Sub Button1_Click(ByVal sender As System.Object, _
   ByVal e As System.EventArgs) Handles Button1.Click
         Dim client As New ServiceReference1.Service1Client
         Dim returnString As String
   
         returnString = client.GetData(TextBox1.Text)
         Label1.Text = returnString
     End Sub
   

5. Klik in Solution Explorer met de rechtermuisknop op het projectknooppunt (bijvoorbeeld WindowsFormsApp1) en selecteer Instellen als Opstartproject.

6. Druk op F5 om het project uit te voeren. Voer tekst in en selecteer de knop. In het label wordt U hebt ingevoerd: gevolgd door uw tekst.

   

Verwante inhoud

• Windows Communication Foundation Services en WCF Data Services in Visual Studio