Как создать шаблон настраиваемого действия

Статья
02/28/2011

Данный раздел относится к версии Windows Workflow Foundation 4.

Настраиваемые шаблоны действий служат для настройки конфигурации действий, в том числе настраиваемых составных действий, чтобы позволяет не создавать отдельно каждое действие и не настраивать все свойства и другие параметры вручную. Эти настраиваемые шаблоны могут быть сделаны доступными в области инструментов средства Конструктор рабочих процессов Windows или в повторно размещенном конструкторе, из которого пользователи могут перетащить их в предварительно настроенную область конструктора. Конструктор рабочих процессов поставляется с хорошими примерами таких шаблонов: SendAndReceiveReply Template Designer и ReceiveAndSendReply Template Designer в категории Messaging Activity Designers.

Первая процедура в этом подразделе описывает способ создания настраиваемого шаблона действий для действия Delay, а вторая процедура кратко описывает, как сделать его доступным в объекте Конструктор рабочих процессов для проверки, что настраиваемый шаблон работает.

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

Создание шаблона для действия Delay

Запустите среду Visual Studio 2010.
В меню Файл последовательно выберите команды Создать и Проект.

Откроется диалоговое окно Новый проект.
В области Типы проектов выберите категорию Рабочий процесс из групп проектов Visual C# или Visual Basic (в зависимости от языка программирования).
В области Шаблоны выберите Библиотека действий.
В поле Имя введите DelayActivityTemplate.
Оставьте значения по умолчанию текстовых полей Расположение и Имя решения, затем нажмите кнопку ОК.
В обозревателе решений щелкните правой кнопкой мыши папку References проекта DelayActivityTemplate и выберите команду Добавить ссылку, чтобы открыть диалоговое окно Добавление ссылки.
Перейдите на вкладку .NET и выберите PresentationFramework из столбца Имя компонента слева, затем нажмите кнопку ОК, чтобы добавить ссылку на файл PresentationFramework.dll.
Повторите процедуру для добавления ссылок на файлы System.Activities.Presentation.dll and the WindowsBase.dll.
Щелкните правой кнопкой мыши проект в окне Обозреватель решений, укажите пункт Добавить и выберите пункт Новый элемент, чтобы открыть диалоговое окно Добавление нового элемента.
Выберите шаблон Class, назовите его MyDelayTemplate, затем нажмите кнопку ОК.

Откройте файл MyDelayTemplate.cs и добавьте следующие инструкции.

//Namespaces added
using System.Activities;
using System.Activities.Statements;
using System.Activities.Presentation;
using System.Windows;

Реализуйте метод IActivityTemplateFactory с помощью класса MyDelayActivity со следующим кодом. Это настраивает задержку на длительность 10 секунд.

    public sealed class MyDelayActivity : IActivityTemplateFactory
    {
        public Activity Create(System.Windows.DependencyObject target)
        {
            return new System.Activities.Statements.Delay
            {
                DisplayName = "DelayActivityTemplate",
                Duration = new TimeSpan(0, 0, 10)

            };
        }
    }

Чтобы создать файл DelayActivityTemplate.dll, выберите команду Построить решение в меню Построение.

Обеспечение доступности шаблона в конструкторе рабочего процесса

Щелкните правой кнопкой мыши решение DelayActivityTemplate в окне Обозреватель решений, укажите пункт Добавить и выберите пункт Новый проект, чтобы открыть диалоговое окно Добавление нового проекта.
Выберите шаблон Workflow Console Application, назовите его CustomActivityTemplateApp, затем нажмите кнопку ОК.
В обозревателе решений щелкните правой кнопкой мыши папку References проекта CustomActivityTemplateApp и выберите команду Добавить ссылку, чтобы открыть диалоговое окно Добавление ссылки.
Перейдите на вкладку Проекты и выберите DelayActivityTemplate из столбца Имя проекта слева, затем нажмите кнопку ОК, чтобы добавить ссылку на файл DelayActivityTemplate.dll.
В окне Обозреватель решений щелкните правой кнопкой мыши проект CustomActivityTemplateApp и выберите команду Построить, чтобы выполнить компиляцию приложения.
В обозревателе решений щелкните правой кнопкой мыши проект CustomActivityTemplateApp и выберите команду Установить как запускаемый проект.
Выберите команду Запустить без отладки из меню Отладка и нажмите любую клавишу для продолжения, когда появится запрос в окне cmd.exe.
Откройте файл Workflow1.xaml и откройте область инструментов.
Перейдите к шаблону MyDelayActivity в категории DelayActivityTemplate. Перетащите его в область конструктора. В окне Свойства подтвердите, что для свойства Duration установлено значение 10 секунд.

Пример

Теперь файл MyDelayActivity.cs должен содержать следующий код.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

//Namespaces added
using System.Activities;
using System.Activities.Statements;
using System.Activities.Presentation;
using System.Windows;

namespace DelayActivityTemplate
{
    public sealed class MyDelayActivity : IActivityTemplateFactory
    {
        public Activity Create(System.Windows.DependencyObject target)
        {
            return new System.Activities.Statements.Delay
            {
                DisplayName = "DelayActivityTemplate",
                Duration = new TimeSpan(0, 0, 10)

            };
        }
    }
}

См. также

Справочник

IActivityTemplateFactory

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