Создание и использование встроенных C# методов (3)

Давайте теперь рассмотрим создание и использование встроенной C# функции на основе шаблона для подключения данных.

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

• Name: PageViews
• Namespace: Demo
• Template: Method using data connection

C1 cгенерит демонстрационный код, который:

• устанавливает соединение с хранилищем данных в C1
• получает все имеющиеся страницы на сайте из типа данных Composite.Data.Types.IPage
• создает список названий этих страниц в виде XML

using (DataConnection connection = new DataConnection(PublicationScope.Unpublished))
{
  XElement element = new XElement("Pages");
  
  foreach (IPage page in connection.Get<IPage>())
  {
    element.Add(new XElement("Page", new XAttribute("title", page.Title)));
  }
  
  return element;
}

Как вы видите в коде используются классы и методы из программного интерфейса данных C1 (Composite C1 API).

На что в этом коде следует обратить внимание?

• Для выполнения CRUD-операций на данными (добавить, получить, изменить, удалить) необходимо установить соединение с хранилищем данных, используя класс Composite.Data.DataConnection.

• Создав экземпляр этого класса, можно теперь выполнять нужные нам операции, вызывая соответствующие методы этого класса - например, получить элементы определенного типа данных - connection.Get<IPage>(). (Подробнее о CRUD операциях при помощи класса DataConnection можно почитать здесь (англ.))

• В демо-коде используется тип (интерфейс) данных Composite.Data.Types.IPage (страницы), который дает доступ ко всем полям этого типа, например, page.Title (название страницы).

(Справочник по Composite C1 API можно найти здесь (англ.).)

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