Bookmark Класс

Определение

Пространство имен:

System.Activities

Сборка:

System.Activities.dll

Представляет точку, в которой рабочий процесс или действие может пассивно ожидать возобновления.

public ref class Bookmark : IEquatable<System::Activities::Bookmark ^>

[System.Runtime.Serialization.DataContract]
public class Bookmark : IEquatable<System.Activities.Bookmark>

[<System.Runtime.Serialization.DataContract>]
type Bookmark = class
    interface IEquatable<Bookmark>

Public Class Bookmark
Implements IEquatable(Of Bookmark)

Наследование

Object

Bookmark

Атрибуты

DataContractAttribute

Реализации

IEquatable<Bookmark>

Примеры

В следующем примере ReadLine создается действие. При выполнении действие ReadLine создает Bookmark, регистрирует обратный вызов, а затем ожидает, когда выполнение Bookmark будет возобновлено. При возобновлении действие ReadLine назначает данные, переданные с помощью Bookmark аргументу Result.

public sealed class ReadLine : NativeActivity<string>
{
    [RequiredArgument]
    public  InArgument<string> BookmarkName { get; set; }

    protected override void Execute(NativeActivityContext context)
    {
        // Create a Bookmark and wait for it to be resumed.
        context.CreateBookmark(BookmarkName.Get(context),
            new BookmarkCallback(OnResumeBookmark));
    }

    // NativeActivity derived activities that do asynchronous operations by calling
    // one of the CreateBookmark overloads defined on System.Activities.NativeActivityContext
    // must override the CanInduceIdle property and return true.
    protected override bool CanInduceIdle
    {
        get { return true; }
    }

    public void OnResumeBookmark(NativeActivityContext context, Bookmark bookmark, object obj)
    {
        // When the Bookmark is resumed, assign its value to
        // the Result argument.
        Result.Set(context, (string)obj);
    }
}

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

Variable<string> name = new Variable<string>
{
    Name = "name"
};

Activity wf = new Sequence
{
    Variables =
    {
        name
    },
    Activities =
    {
        new WriteLine()
        {
            Text = "What is your name?"
        },
        new ReadLine()
        {
            BookmarkName = "UserName",
            Result = name
        },
        new WriteLine()
        {
            Text = new InArgument<string>((env) => "Hello, " + name.Get(env))
        }
    }
};

AutoResetEvent syncEvent = new AutoResetEvent(false);

// Create the WorkflowApplication using the desired
// workflow definition.
WorkflowApplication wfApp = new WorkflowApplication(wf);

// Handle the desired lifecycle events.
wfApp.Completed = delegate(WorkflowApplicationCompletedEventArgs e)
{
    // Signal the host that the workflow is complete.
    syncEvent.Set();
};

// Start the workflow.
wfApp.Run();

// Collect the user's name and resume the bookmark.
// Bookmark resumption only occurs when the workflow
// is idle. If a call to ResumeBookmark is made and the workflow
// is not idle, ResumeBookmark blocks until the workflow becomes
// idle before resuming the bookmark.
wfApp.ResumeBookmark("UserName", Console.ReadLine());

// Wait for Completed to arrive and signal that
// the workflow is complete.
syncEvent.WaitOne();

При выполнении действия ReadLine создается Bookmark с именем UserName, а затем система ожидает возобновления закладки. Хост собирает нужные данные и затем возобновляет работу Bookmark. Рабочий процесс возобновляется, отображает имя и завершает работу. Обратите внимание, что код синхронизации не требуется для возобновления закладки. Bookmark можно возобновить только тогда, когда рабочий процесс простаивает. Если рабочий процесс не простаивает, вызов ResumeBookmark блокируется до тех пор, пока рабочий процесс не станет неактивным.

Комментарии

При создании Bookmarkдействия он становится бездействующий и ожидает Bookmark возобновления. Если существуют другие действия параллельно с созданным Bookmarkдействием, они будут запланированы для выполнения.

Закладки можно возобновить с помощью ведущего приложения с помощью одной из ResumeBookmark перегрузок.

Дополнительные сведения о закладках см. в разделе Using WorkflowInvoker и WorkflowApplication и Bookmarks.

Конструкторы

Имя	Описание
Bookmark(String)	Инициализирует новый экземпляр класса с помощью указанного Bookmark имени.

Свойства

Имя	Описание
Name	Возвращает имя закладки.

Методы

Имя	Описание
Equals(Bookmark)	Определяет, относится ли текущий Bookmark и указанный Bookmark пункт продолжения к той же точке продолжения в рабочем процессе.
Equals(Object)	Определяет, относится ли текущий Bookmark и указанный объект к одной точке продолжения рабочего процесса.
GetHashCode()	Возвращает уникальный идентификатор для этого Bookmark экземпляра.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает имя закладки для именованной закладки или идентификатора закладки для неименованной закладки.