Návod: Vytvoření jednoduché služby WCF v rozhraní .NET Framework model Windows Forms

Tento návod ukazuje, jak vytvořit jednoduchou službu WCF (Windows Communication Foundation), otestovat ji a pak k ní přistupovat z rozhraní .NET Framework model Windows Forms aplikace.

Poznámka:

V počítači se můžou zobrazovat různé názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio v tomto článku. Možná používáte jinou edici sady Visual Studio nebo jiné nastavení prostředí. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí (IDE).

Požadavky

Nástroje WCF nejsou nainstalovány s úlohou .NET; k úpravě instalace použijte Instalační program pro Visual Studio. V instalačním programu zvolte v části Jednotlivé součásti službu Windows Communication Foundation . Viz Úprava sady Visual Studio.

Vytvoření služby

1. Otevřete sadu Visual Studio.

2. V úvodním okně zvolte Vytvořit nový projekt.

3. Do vyhledávacího pole na stránce Vytvořit nový projekt zadejte knihovnu služby WCF. Vyberte šablonu jazyka C# nebo Visual Basic pro knihovnu služeb WCF a pak vyberte Další.

   

   Tip

   Pokud nevidíte žádné šablony, možná budete muset nainstalovat komponentu Windows Communication Foundation sady Visual Studio. Zvolte Nainstalovat další nástroje a funkce a otevřete Instalační program pro Visual Studio. Zvolte kartu Jednotlivé komponenty, posuňte se dolů k aktivitám Vývoj a pak vyberte Windows Communication Foundation. Klepněte na tlačítko Upravit.

4. Na stránce Konfigurovat nový projekt klikněte na Vytvořit.

   Poznámka:

   Tím se vytvoří funkční služba, ke které je možné testovat a přistupovat. Následující dva kroky ukazují, jak můžete výchozí metodu upravit tak, aby používala jiný datový typ. Ve skutečné aplikaci byste do služby přidali také vlastní funkce.

5. V Průzkumník řešení poklikejte na IService1.vb nebo IService1.cs.

   

   Najděte následující řádek:

   C#

   [OperationContract]
   string GetData(int value);
   

   VB

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

---

Změňte typ parametru value na řetězec:

C#

[OperationContract]
string GetData(string value);

VB

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

Ve výše uvedeném kódu si všimněte atributu OperationContract . Tento atribut je vyžadován pro jakoukoli metodu vystavenou službou.

6. V Průzkumník řešení poklikejte na Service1.vb nebo Service1.cs.

   

   Najděte následující řádek:

   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
   

---

Změňte typ parametru value na řetězec:

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

Testování služby

1. Službu spustíte stisknutím klávesy F5 . Zobrazí se formulář testovacího klienta WCF a načte službu.

2. Ve formuláři Wcf Test Client poklikejte na metodu GetData() v části IService1. Zobrazí se karta GetData .

   

3. V poli Požadavek vyberte pole Hodnota a zadejte Hello.

   

4. Klikněte na tlačítko Vyvolat . Pokud se zobrazí dialogové okno Upozornění zabezpečení, klepněte na tlačítko OK. Výsledek se zobrazí v poli Odpověď .

   

5. V nabídce Soubor klepněte na tlačítko Ukončit zavřete testovací formulář.

Přístup ke službě

Odkaz na službu WCF

1. V nabídce Soubor přejděte na příkaz Přidat > nový projekt. Zvolte projekt aplikace model Windows Forms (.NET Framework).

2. Klikněte pravým tlačítkem myši na uzel projektu a klikněte na Přidat > odkaz na službu. Zobrazí se dialogové okno Přidat odkaz na službu.

3. V dialogovém okně Přidat odkaz služby klepněte na tlačítko Zjistit.

   

   Služba1 se zobrazí v podokně Služby .

4. Kliknutím na tlačítko OK přidáte odkaz na službu.

Sestavení klientské aplikace

1. V Průzkumník řešení poklikáním na Form1.vb nebo Form1.cs otevřete návrháře model Windows Forms, pokud ještě není otevřený.

2. Otevřete panel nástrojů kliknutím na Zobrazit>sadu nástrojů (nebo ctrl+Alt+X na klávesnici).

3. Z panelu nástrojů přetáhněte TextBox ovládací prvek, Label ovládací prvek a Button ovládací prvek do formuláře.

   

4. Poklikejte na položku Buttona do obslužné rutiny události přidejte následující kód Click :

   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. V Průzkumník řešení klikněte pravým tlačítkem myši na uzel projektu (například WindowsFormsApp1) a klikněte na Nastavit jako spouštěcí projekt.

6. Stisknutím klávesy F5 spusťte projekt. Zadejte nějaký text a klikněte na tlačítko. Popisek zobrazí text", který jste zadali:" a zobrazí text, který jste zadali.

   

Související obsah

• Služby Windows Communication Foundation a služby WCF Data Services v sadě Visual Studio