逐步解說：在 .NET Framework Windows Forms 中建立 WCF 服務

發行項
2025-04-04

本逐步解說示範如何建立 Windows Communication Foundation （WCF）服務、測試它，然後從 .NET Framework Windows Forms 應用程式存取它。

備註

您的電腦可能會顯示本文中某些 Visual Studio 使用者介面元素的不同名稱或位置。您可能使用不同的 Visual Studio 版本或不同的環境設定。如需詳細資訊，請參閱個人化 IDE。

先決條件

已安裝 Windows Communication Foundation 元件的 Visual Studio。若要安裝：

開啟 Visual Studio 安裝程式應用程式，或從 Visual Studio 功能表中選取工具>取得工具與功能。
在 Visual Studio 安裝程式中，選擇您想要修改之 Visual Studio 版本旁的 [修改 ]。
選取 [個別元件] 索引卷標，然後選擇 [開發活動] 底下的 [Windows Communication Foundation]。
選取修改。

如需詳細資訊，請參閱修改Visual Studio工作負載、元件和語言套件。

建立 WCF 服務

若要在 Visual Studio 中建立 WCF 服務，請遵循下列步驟：

在 Visual Studio 中，從功能表中選取 [ 檔案>新>專案 ]。
在 [ 建立新專案] 頁面上，於搜尋方塊中輸入 wcf 服務連結庫 。選取 WCF 服務連結庫的 C# 或 Visual Basic 樣本，然後選取 [ 下一步]。

小提示

如果您沒有看到任何範本，您可能需要安裝Visual Studio的 Windows Communication Foundation 元件。如需詳細資訊，請參閱必要條件
在 [ 設定新專案 ] 頁面上，確認設定，然後選取 [ 建立]。

此步驟會建立可測試及存取的工作 WCF 服務。下列步驟示範如何修改預設方法以使用不同的數據類型。在實際的應用程式中，您也會將自己的功能新增至服務。
在 [方案總管] 中，根據您建立的專案類型，按兩下 WCF 服務庫專案中的 IService1.cs 或 IService1.vb。

尋找下列這一行：

[OperationContract]
string GetData(int value);

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

將參數的類型 value 變更為字串。

在此程式代碼範例中，請注意 OperationContract 屬性。服務所公開的任何方法都需要這個屬性。
- C#
- VB
```
[OperationContract]
string GetData(string value);
```
```
<OperationContract()>
Function GetData(ByVal value As String) As String
```

在 [方案總管] 中，按兩下 Service1.cs 或 Service1.vb。

在編輯器中，尋找下列這一行：

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

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

將參數的類型 value 變更為字串，如下所示：

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

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

測試 WCF 服務

若要測試您所建立的 WCF 服務，請遵循下列步驟：

按 F5 以執行服務。

WCF 測試用戶端表單隨即出現並載入服務。
在 [IService1] 下，按兩下 GetData（） 方法。

GetData 選項卡會出現在WCF 測試用戶端表單中。
在 [GetData] 索引標籤的 [要求] 方塊中，選取 [值] 欄位並輸入 Hello。
選取 [叫用] 按鈕。如果出現 [安全性警告] 對話框，請選取 [確定]。

結果會顯示在 [ 回應 ] 方塊中。
在 [ 檔案] 功能表上，選取 [ 結束 ] 以關閉測試表單。

存取 WCF 服務

建立及測試 WCF 服務之後，您可以從項目參考它，並使用它來建置用戶端應用程式。

參考 WCF 服務

若要從項目參考 WCF 服務，請遵循下列步驟：

選取檔案>新增>專案。
在 [ 新增專案] 視窗中，選擇 C# 或 Visual Basic Windows Forms 應用程式（.NET Framework） 專案。選取 [下一步]，然後選取 [ 建立] 以建立專案。
在 [方案總管] 中，以滑鼠右鍵按兩下新專案的項目節點，然後選取 [新增>服務參考]。

[ 新增服務參考 ] 對話框隨即出現。
選取探索。

Service1 會顯示在 [ 服務 ] 窗格中。
選取 [確定 ] 以新增服務參考。

建置用戶端應用程式

若要使用 WCF 服務參考來建置用戶端應用程式，請遵循下列步驟。

在 [方案總管] 中，在 Windows Forms 應用程式中雙擊 Form1.cs 或 Form1.vb。

窗體會在 Windows Forms 設計工具中開啟。
從功能表中選取 [檢視>工具箱]，或從鍵盤按 Ctrl+Alt+X，以開啟 [工具箱]。
從 [工具箱] 中，將 TextBox 控制件、標籤件和 Button 控制件拖曳到表單上。

按兩下 Button 控制件，然後在事件處理程式中 Click 新增下列程式代碼：

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;
}

  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

在 [方案總管] 中，以滑鼠右鍵按兩下項目節點（例如 WindowsFormsApp1），然後選取 [ 設定為啟始專案]。
按 F5 執行專案。輸入一些文字，然後選取按鈕。標籤會顯示 您輸入：，後面接著您的文字。

Visual Studio 中的 Windows Communication Foundation Services 和 WCF Data Services

共用方式為