Пошаговое руководство. Создание службы WCF в .NET Framework Windows Forms

2025-06-12

В этом пошаговом руководстве показано, как создать службу Windows Communication Foundation (WCF), протестировать ее, а затем получить доступ к ней из приложения .NET Framework Windows Forms.

Примечание.

Инструкции в этой статье иллюстрируют последнюю версию интерактивного интерфейса разработки (IDE), доступную в Visual Studio. На компьютере могут отображаться различные имена или расположения для некоторых элементов пользовательского интерфейса. Вы можете использовать другую версию Visual Studio или разные параметры среды. Дополнительные сведения см. в разделе Персонализация интегрированной среды разработки.

Предпосылки

Visual Studio с установленным компонентом Windows Communication Foundation . Чтобы установить его, выполните приведенные далее действия.

Откройте приложение Установщик Visual Studio или выберите Инструменты>Получить средства и компоненты в меню Visual Studio.
В Visual Studio Installer выберите "Изменить " рядом с версией Visual Studio, которую вы хотите изменить.
Перейдите на вкладку "Отдельные компоненты" и выберите Windows Communication Foundation в разделе "Действия по разработке".
Нажмите кнопку Изменить.

Дополнительные сведения см. в разделе "Изменение рабочих нагрузок, компонентов и языковых пакетов Visual Studio".

Создание службы WCF

Чтобы создать службу WCF в Visual Studio, выполните следующие действия.

В Visual Studio выберите Файл>Создать>Проект в меню.
На странице создания проекта введите библиотеку служб wcf в поле поиска. Выберите шаблон C# или Visual Basic для библиотеки служб WCF и нажмите кнопку "Далее".

Подсказка

Если вы не видите шаблонов, может потребоваться установить компонент Windows Communication Foundation Visual Studio. Дополнительные сведения см. в разделе "Предварительные требования"
На странице "Настройка нового проекта" проверьте параметры и нажмите кнопку "Создать".

На этом шаге создается рабочая служба WCF, которую можно протестировать и получить к ней доступ. Ниже показано, как изменить метод по умолчанию для использования другого типа данных. В реальном приложении вы также добавите собственные функции в службу.
В обозревателе решений дважды щелкните IService1.cs или IService1.vb в проекте библиотеки служб WCF в зависимости от типа созданного проекта.

Найдите следующую строку:

[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 из проекта, выполните следующие действия.

Выберите Файл>Добавить>Новый проект.
В окне Добавить новый проект, выберите проект Windows Forms App на C# или Visual Basic (.NET Framework). Нажмите кнопку "Далее", а затем создайте проект.
В обозревателе решений щелкните правой кнопкой мыши узел проекта нового проекта и выберите "Добавить>ссылку на службу".

Откроется диалоговое окно "Добавить ссылку на службу ".
Выберите "Обнаружить".

Служба1 отображается на панели "Службы ".
Нажмите кнопку "ОК ", чтобы добавить ссылку на службу.

Создание клиентского приложения

Чтобы использовать ссылку на службу WCF для создания клиентского приложения, выполните следующие действия.

В обозревателе решений дважды щелкните Form1.cs или Form1.vb в приложении Windows Forms.

Форма откроется в конструкторе Windows Forms.
Откройте панель инструментов, выбрав пункт меню Вид>Панель инструментов, или нажмите на клавиатуре Ctrl+Alt+X.
Перетащите из панели элементов элементы управления TextBox, Label и 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 , чтобы запустить проект. Введите текст и нажмите кнопку. Метка отображает Вы ввели:, за которым следует ваш текст.

Службы Windows Communication Foundation и службы данных WCF в Visual Studio

Поделиться через