官术网_书友最值得收藏!

Customizing a MyReadLine activity with Bookmark

By using InArgument, OutArgument, and InOutArgument, we can flow data into the workflow when it starts and out of the workflow when it ends. But how can we pass data from the caller into the workflow when it is executing?—Bookmark will help us to do this. In this task, we will create a MyReadLine activity using a bookmark.

How to do it...

  1. Create a workflow project:

    Create a new Workflow Console Application under the Chapter01 solution and name the project as UseBookmark. Next, add a code file to this project and name the file as MyReadLineActivity. We can see this in the following screenshot:

    How to do it...
  2. Customize the activity with Bookmark:

    Fill the opening MyReadLineActivity.cs file with the following code:

    using System.Activities;
    namespace UseBookmark{
        public class MyReadLine : NativeActivity<string>{
            [RequiredArgument]
            public InArgument<string> BookmarkName { get; set; }
            protected override void Execute(
                NativeActivityContext context)
            {
                context.CreateBookmark(BookmarkName.Get(context),
                         new BookmarkCallback(OnResumeBookmark));
            }
            protected override bool CanInduceIdle
            {
                get
                {
                    { return true;}
                }
            }
            public void OnResumeBookmark(
                NativeActivityContext context,
                Bookmark bookmark,
                object obj)
            {
                Result.Set(context, (string)obj);
            }
        }
    }
    

    Save the file and press F6 to build the project so that the activity will appear in the WF designer activity toolbox.

  3. Author a workflow:

    Open Workflow1.xaml and author the workflow as shown in the following screenshot:

    How to do it...
  4. Write code to host the workflow:

    Open Program.csfile and change the code as follows:

    using System;
    using System.Linq;
    using System.Activities;
    using System.Activities.Statements;
    using System.Threading;
    
    namespace UseBookmark{
        class Program{
            static void Main(string[] args)
            {
                AutoResetEvent syncEvent = 
                    new AutoResetEvent(false);
                string bookmarkName="GreetingBookmark";
                WorkflowApplication wfApp = 
                    new WorkflowApplication(new Workflow1()
                {
                    BookmarkNameInArg=bookmarkName
                });
                wfApp.Completed = delegate(
                    WorkflowApplicationCompletedEventArgs e)
                {
                    syncEvent.Set();
                };
                wfApp.Run();
                wfApp.ResumeBookmark(bookmarkName, 
                    Console.ReadLine());
                syncEvent.WaitOne();
            }
        }
    }
    
  5. Run it:

    Set UseBookmark as Startup project. Press Ctrl+F5 to build and run the workflow without debugging. The application should run in a console window and print the message as shown in the following screenshot:

    How to do it...

How it works...

In the code shown in the second step, we create a class inherited from NativeActivity. NativeActivity is a special abstract activity that can be used to customize complex activities; we will talk about it more in Chapter 5, Custom Activities.

context.CreateBookmark(BookmarkName.Get(context),
        new BookmarkCallback(OnResumeBookmark));

By this statement, the WF context creates a Bookmark with arguments BookMarkName and BookMarkCallback. When the wfApp.ResumeBookmark method is called, the OnResumeBookmark that was defined in the Customized Activity body will be executed.

protected override bool CanInduceIdle{
    get
    {
        { return true;}
    }
}

This is a built-in property that indicates whether the customized activity can cause the workflow to become idle; the default value is false.

Consider the following code snippet of step 3:

wfApp.ResumeBookmark(bookmarkName, 
                Console.ReadLine());

When this statement is executed, the OnResumeBookmark method defined in the MyReadLine activity will be called and the method will accept the value passed via Console.ReadLine().

主站蜘蛛池模板: 宁明县| 安西县| 肥城市| 汉寿县| 凌源市| 米泉市| 兴业县| 衡南县| 太湖县| 太仆寺旗| 镇原县| 惠安县| 鄂托克旗| 富源县| 荥阳市| 雷山县| 海安县| 桑植县| 湾仔区| 常州市| 云浮市| 合水县| 怀安县| 明光市| 台前县| 林州市| 剑川县| 金秀| 临汾市| 繁峙县| 大新县| 铜梁县| 江孜县| 清水县| 云龙县| 孝感市| 定陶县| 惠安县| 新疆| 资溪县| 嘉鱼县|