Шаблоны WCF Visual Studio

Шаблоны Visual Studio для Windows Communication Foundation (WCF) — это стандартные шаблоны проектов и элементов, которые можно использовать в Visual Studio для быстрого создания служб WCF и окружающих приложений.

Использование шаблонов WCF

Шаблоны WCF в Visual Studio предоставляют базовую структуру классов для разработки служб. В частности, эти шаблоны предоставляет основные определения для контракта службы, контракта данных, реализации службы и конфигурации. Эти шаблоны можно использовать для создания простой службы, которая потребует минимального программирования, и которая может служить как стандартный блок для более сложных служб.

Шаблон проекта библиотеки служб WCF

Шаблон проекта библиотеки служб WCF доступен в диалоговом окне нового проекта в разделе Visual C#\WCF и Visual Basic\WCF.

При создании проекта с помощью шаблона службы WCF новый проект автоматически включает следующие три файла:

  • файл контракта службы (IService1.cs или IService1.vb); Файл контракта службы — это интерфейс, имеющий примененные атрибуты службы WCF. Этот файл предоставляет определение простой службы, чтобы показать как определяются пользовательские службы, он включает параметризованные операции и простой образец контракта данных. Это файл по умолчанию, отображаемый в редакторе кода после создания проекта службы WCF.

  • Файл реализации службы (Service1.cs или Service1.vb). Файл реализации службы реализует контракт, определенный в файле контракта службы.

  • Файл конфигурации приложения (App.config). Файл конфигурации предоставляет основные элементы модели службы WCF с безопасной привязкой HTTP. Также включает конечную точку для службы и позволяет осуществлять обмен метаданными.

Примечание.

Visual Studio настраивается для распознавания файла App.config в качестве файла конфигурации для проекта при запуске с помощью узла службы WCF (WcfSvcHost.exe), который является конфигурацией по умолчанию. Если размещать библиотеку службы в исполняемом файле, то необходимо переместить код конфигурации в файл конфигурации исполняемого файла, так как файлы конфигурации для DLL-библиотек являются недопустимыми.

Шаблон веб-приложения службы WCF

Шаблон приложения службы WCF доступен в диалоговом окне "Новый проект" в разделе Visual C#\WCF и Visual Basic\WCF.

При создании проекта с помощью шаблона службы веб-приложений WCF проект включает следующие четыре файла:

  • файл ведущего приложения службы (service1.svc);

  • файл контракта службы (IService1.cs или IService1.vb);

  • файл реализации службы (Service1.svc.cs или Service1.svc.vb);

  • файл веб-конфигурации (Web.config).

Шаблон автоматически создает веб-сайт (развертывается в виртуальном каталоге) и размещает в нем службу.

Шаблон веб-сайта WCF

Шаблон веб-сайта WCF доступен в диалоговом окне "Новый проект" в разделе Visual C#\Web Site\WCF Service и Visual Basic\Web Site\WCF Service. Создаются те же файлы, что и с шаблоном приложения службы WCF, но при этом шаблон организуется так, как если бы он представлял собой веб-сайт ASP.NET. Создаются папки App_Code и App_Data.

Шаблон элемента службы WCF

Шаблон элемента службы WCF — это пользовательский шаблон, который позволяет быстро добавлять службы WCF в существующие проекты Visual Studio.

Чтобы использовать этот шаблон, перейдите в область Обозреватель решений, щелкните правой кнопкой мыши имя проекта, выберите пункт "Добавить" и нажмите кнопку "Создать элемент", чтобы запустить диалоговое окно "Добавить новый элемент".

Интерфейс службы и файлы реализации размещаются в корневой папке проекта.

Шаблон попытается включить раздел конфигурации новой службы в существующий файл конфигурации, при условии что у них совместимые типы.

Если существующий проект является веб-проектом, то также создается файл узла службы (service1.svc).

Шаблон элемента и проект службы WF WCF.

Эти шаблоны создают службы WCF, на которых размещена служба рабочего процесса, которая является рабочим процессом, к которому можно получить доступ как к веб-службе. Для моделей императивного программирования и XAML существуют отдельные шаблоны. Используя эти шаблоны, можно создать последовательный рабочий процесс или рабочий процесс конечного автомата. Дополнительные сведения об этих типах рабочих процессов см. в статье "Практическое руководство. Создание рабочего процесса". Дополнительные сведения о создании проектов рабочих процессов см. в разделе "Создание устаревших проектов рабочих процессов".

Конструктор Visual Studio более адаптивн, если рабочие процессы типов XOML используются вместо кодовых рабочих процессов. Рабочий процесс XOML - это создаваемый по умолчанию тип рабочего процесса.

Шаблон библиотеки служб синдикации WCF.

Этот шаблон позволяет предоставлять веб-канал в формате RSS или ATOM в качестве службы WCF. Дополнительные сведения см. в статье WCF Syndication.

Изменение адреса веб-канала

Шаблон синдикации использует веб-браузер во время выполнения. Щелкнув правой кнопкой мыши проект в Обозреватель решений в Visual Studio, выберите пункт "Свойства", а затем перейдите на вкладку "Отладка" и вы увидите адрес шаблона по умолчанию. Браузер пытается открыть веб-канал по этому адресу.

При изменении адреса веб-канала необходимо также изменить адрес на вкладке "Отладка ". Если этого не сделать, браузер пытается открыть веб-канал по адресу по умолчанию и завершается сбоем.

Шаблон элемента службы WCF с поддержкой AJAX

Этот шаблон предоставляет элемент управления AJAX как службу WCF. Дополнительные сведения об элементах управления AJAX см. в документации по элементу управления AJAX.

Шаблон элемента службы WCF с поддержкой Silverlight

Этот шаблон создает веб-службу, которая предоставляет данные клиенту Silverlight или внешнему интерфейсу. Шаблон можно добавить на веб-сайт или проект веб-приложения для создания службы WCF, которая включает код службы и конфигурацию, которая поддерживает взаимодействие с клиентом Silverlight. Затем можно добавить ссылку на службу для добавления прокси-сервера клиента в клиент и обмена данными между клиентом Silverlight и службой WCF с поддержкой Silverlight.

Чтобы получить доступ к этому шаблону, щелкните правой кнопкой мыши веб-сайт или проект веб-приложения в Обозреватель решений, щелкните "Добавить новый элемент" и выберите службу WCF с поддержкой Silverlight.

Примечание.

Служба WCF с поддержкой Silverlight предоставляет доступ к конечной точке basicHttpBinding без применения параметров безопасности. Поэтому сведения о службе могут быть получены всеми клиентами, которые подключены к этой службе. Сообщения, которыми обмениваются служба и клиент, также не подписываются и не шифруются. Для защиты конечной точки необходимо использовать проверку подлинности ASP.NET, протокол HTTPS или другие механизмы.

См. также