Как определить контракт службы Windows Communication Foundation

Практическое руководство по программной реализации WCF-служб

Источник: https://msdn.microsoft.com/ru-ru/library/ms734712%28v=vs.110%29.aspx

Содержащиеся в этом разделе подразделы призваны кратко познакомить читателя с процессом программирования в Windows Communication Foundation (WCF). Их нужно выполнять в том порядке, в котором они перечислены в конце этой страницы. Прохождение этих занятий позволит получить базовое представление об этапах, которые необходимы для создания служб и клиентских приложений WCF. Служба представляет собой конструкцию, предоставляющую одну или несколько конечных точек, каждая из которых предоставляет одну или несколько операций службы. Конечная точка службы задает адреса, по которым можно найти службу, привязку, содержащую сведения, которыми клиент должен обмениваться со службой, и контракт, который определяет функциональность, предоставляемую службой клиентам.

После выполнения последовательности занятий будет создана готовая служба и клиент, который может вызывать операции этой службы. В первых трех разделах описано, как определить службу с помощью контракта, как реализовать службу и как настроить службу в коде, а также как разместить и запустить ее. Созданная служба размещается резидентно, а клиент и служба выполняются на одном и том же компьютере. Служба настраивается с помощью кода, а не файла конфигурации. Службы можно размещать в службах IIS. Дополнительные сведения о том, как сделать это, см в разделе Практическое руководство. Как разместить службу WCF в IIS. Кроме того, службы можно настраивать с помощью файла конфигурации. Дополнительные сведения о использовании файла конфигурации см. в разделе Настройка служб с использованием файлов конфигурации.

В следующих трех разделах описано, как создать прокси клиента, настроить клиентское приложение, а также создать и использовать клиент, который может обращаться к функциональности службы. Службы публикуют доступные метаданные, которые определяют конструкции, необходимые клиентским приложениям для взаимодействия с операциями службы. WCF предоставляет средство Служебное средство ServiceModel Metadata Utility Tool (Svcutil.exe) для автоматизации процесса доступа к опубликованным метаданным и их использования для настройки клиентского приложения для службы.

Во всех занятиях этого раздела предполагается, что в качестве среды разработки используется версия Visual Studio 2010 или выше.

Как определить контракт службы Windows Communication Foundation

Это первый из шести шагов, необходимых для создания базового приложения Windows Communication Foundation (WCF).

При создании службы WCF необходимо в первую очередь определить контракт службы. В контракте службы указываются операции, поддерживаемые службой. Операцию можно представлять себе как метод веб-службы. Контракты создаются путем определения интерфейса C++, C# или Visual Basic. Каждый метод в интерфейсе соответствует определенной операции службы. К каждому интерфейсу должен быть применен атрибут ServiceContractAttribute, а к каждой операции должен быть применен атрибут OperationContractAttribute. Если один из методов в интерфейсе, имеющем атрибут ServiceContractAttribute, не имеет атрибута OperationContractAttribute, этот метод не будет представлен службой.

Код, используемый для выполнения этой задачи, приведен в примере после описания процедуры.