Элемент Function (язык CSDL)

Статья
02/28/2011

Элемент Function в языке CSDL используется для определения или объявления функций в концептуальной модели. Функция определяется с использованием элемента DefiningExpression. Дополнительные сведения см. в разделе How to: Define Custom Functions in the Conceptual Model.

Элемент Function может иметь следующие дочерние элементы (в порядке перечисления).

Documentation (ноль или один элемент)
Parameter (ноль или больше элементов)
DefiningExpression (ноль или один элемент)
ReturnType (ноль или один элемент)
Элементы Annotation (ноль или более элементов)

Возвращаемый тип для функции должен быть указан с помощью либо элемента ReturnType, либо атрибута ReturnType (см. ниже), но не того и другого. Возвращаемым типом может быть EdmSimpleType, тип сущности, сложный тип, строковый тип, ссылочный тип или коллекция, которая включает один из этих типов. Дополнительные сведения см. в разделе Типы концептуальной модели.

Применимые атрибуты

В таблице ниже описываются атрибуты, которые можно применить к элементу Function.

Имя атрибута	Необходимо	Значение
Name	Да	Имя функции.
ReturnType	Нет	Тип, возвращаемый функцией.

Примечание
К элементу Function может быть применено любое количество атрибутов annotation (настраиваемых атрибутов XML).Однако настраиваемые атрибуты не могут принадлежать к любому пространству имен XML, зарезервированному для CSDL.Полные имена любых двух настраиваемых атрибутов не могут совпадать.

К элементу Function может быть применено любое количество атрибутов annotation (настраиваемых атрибутов XML).Однако настраиваемые атрибуты не могут принадлежать к любому пространству имен XML, зарезервированному для CSDL.Полные имена любых двух настраиваемых атрибутов не могут совпадать.

Пример

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

<Function Name="YearsSince" ReturnType="Edm.Int32">
  <Parameter Name="date" Type="Edm.DateTime" />
  <DefiningExpression>
    Year(CurrentDateTime()) - Year(date)
  </DefiningExpression>
</Function>

См. также

Основные понятия

Общие сведения о платформе Entity Framework
Спецификация языка CSDL
Элемент FunctionImport (язык CSDL)

Другие ресурсы

Спецификации языка CSDL, SSDL и MSL
ADO.NET Entity Data Model Tools
model-defined function (Entity Data Model)

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