Dela via


Genomgång: Skapa en WCF-tjänst i .NET Framework Windows Forms

Den här genomgången visar hur du skapar en WCF-tjänst (Windows Communication Foundation), testar den och sedan kommer åt den från ett .NET Framework Windows Forms-program.

Anmärkning

Anvisningarna i den här artikeln illustrerar den senaste versionen av den interaktiva utvecklingsupplevelsen (IDE) som är tillgänglig i Visual Studio. Datorn kan visa olika namn eller platser för vissa av användargränssnittselementen. Du kanske använder en annan version av Visual Studio eller andra miljöinställningar. Mer information finns i Anpassa IDE-.

Förutsättningar

Visual Studio med Komponenten Windows Communication Foundation installerad. Så här installerar du den:

  1. Öppna Visual Studio Installer-appen eller välj Verktyg>Hämta verktyg och funktioner på Visual Studio-menyn.
  2. I Visual Studio Installer väljer du Ändra bredvid den version av Visual Studio som du vill ändra.
  3. Välj fliken Enskilda komponenter och välj sedan Windows Communication Foundation under Utvecklingsaktiviteter.
  4. Välj Ändra.

Mer information finns i Ändra Visual Studio-arbetsbelastningar, komponenter och språkpaket.

Skapa en WCF-tjänst

Följ dessa steg för att skapa en WCF-tjänst i Visual Studio:

  1. I Visual Studio väljer du Arkiv>Nytt>projekt på menyn.

  2. På sidan Skapa ett nytt projekt anger du wcf-tjänstbiblioteket i sökrutan. Välj antingen C# eller Visual Basic-mallen för WCF-tjänstbiblioteket och välj sedan Nästa.

    Skärmbild som visar hur du skapar ett WCF-tjänstbiblioteksprojekt i Visual Studio.

    Tips/Råd

    Om du inte ser några mallar kan du behöva installera Windows Communication Foundation-komponenten i Visual Studio. Mer information finns i Krav

  3. På sidan Konfigurera ditt nya projekt kontrollerar du inställningarna och väljer sedan Skapa.

    Det här steget skapar en fungerande WCF-tjänst som du kan testa och komma åt. Följande steg visar hur du ändrar standardmetoden för att använda en annan datatyp. I ett riktigt program lägger du också till dina egna funktioner i tjänsten.

  4. Dubbelklicka på IService1.cs eller IService1.vb i ditt WCF-tjänstbiblioteksprojekt i Solution Explorer, beroende på vilken typ av projekt du skapade.

    Skärmbild som visar IService1-filen i Solution Explorer.

  5. Hitta följande rad:

    [OperationContract]
    string GetData(int value);
    

  1. Ändra typen för parametern value till sträng.

    Observera attributet i det här kodexemplet OperationContract . Det här attributet krävs för alla metoder som exponeras av tjänsten.

    [OperationContract]
    string GetData(string value);
    

  1. Dubbelklicka på Service1.cs eller Service1.vb i Solution Explorer.

    Skärmbild som visar Service1-filen i Solution Explorer.

  2. I redigeraren hittar du följande rad:

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

  1. Ändra typen för parametern value till sträng enligt följande:

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

Testa WCF-tjänsten

Följ dessa steg för att testa WCF-tjänsten som du skapade:

  1. Tryck på F5 för att köra tjänsten.

    WCF-testklientens formulär visas och läser in tjänsten.

  2. Under IService1 dubbelklickar du på metoden GetData().

    Fliken GetData visas i formuläret WCF-testklient .

    Skärmbild som visar metoden GetData i formuläret WCF-testklient.

  3. I rutan Begäran på fliken GetData väljer du fältet Värde och anger Hello.

    Skärmbild som visar fältet Värde på fliken GetData.

  4. Välj knappen Anropa . Om dialogrutan Säkerhetsvarning visas väljer du OK.

    Resultatet visas i rutan Svar .

    Skärmbild som visar resultatet som visas i rutan Svar på fliken GetData.

  5. menyn Arkiv väljer du Avsluta för att stänga testformuläret.

Få åtkomst till WCF-tjänsten

När du har skapat och testat WCF-tjänsten kan du referera till den från ett projekt och använda den för att skapa ett klientprogram.

Referera till WCF-tjänsten

Följ dessa steg för att referera till WCF-tjänsten från ett projekt:

  1. Välj Arkiv>Lägg till>nytt projekt.

  2. I fönstret Lägg till ett nytt projekt väljer du antingen ett C#- eller Visual Basic Windows Forms App-projekt (.NET Framework). Välj Nästa och sedan Skapa för att skapa projektet.

  3. Högerklicka på projektnoden för det nya projektet i Solution Explorer och välj Lägg till>tjänstreferens.

    Dialogrutan Lägg till tjänstreferens visas.

  4. Välj Identifiera.

    Skärmbild som visar dialogrutan Lägg till tjänstreferens.

    Service1 visas i fönstret Tjänster .

  5. Välj OK för att lägga till tjänstreferensen.

Skapa ett klientprogram

Följ dessa steg om du vill använda en WCF-tjänstreferens för att skapa ett klientprogram.

  1. Dubbelklicka på Form1.cs eller Form1.vb i Windows Forms-appen i Solution Explorer.

    Formuläret öppnas i Windows Forms Designer.

  2. Öppna verktygslådan genom att välja Visa>verktygslåda på menyn eller tryck på Ctrl+Alt+X från tangentbordet.

  3. Dra en TextBox-kontroll, en etikettkontroll och en knappkontroll till formuläret från verktygslådan.

    Skärmbild som visar hur du lägger till kontroller i klientprogramformuläret.

  4. Dubbelklicka på knappkontrollen och lägg till följande kod i Click händelsehanteraren:

    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;
    }
    
  5. I Solution Explorer högerklickar du på projektnoden (till exempel WindowsFormsApp1) och väljer Ange som startprojekt.

  6. Tryck på F5 för att köra projektet. Ange text och välj knappen. Etiketten visar Du har angett:, följt av texten.

    Skärmbild som visar resultatet som visas i klientprogramformuläret som körs.