WorkflowApplication.ResumeBookmark Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Запускает операцию продолжения чтения с закладки.
Перегрузки
ResumeBookmark(String, Object, TimeSpan) |
Запускает операцию для возобновления закладки с указанным именем, используя указанное значение и интервал времени ожидания. Закладка, с которой будет продолжено чтение, ранее создавалась действием в экземпляре рабочего процесса. |
ResumeBookmark(Bookmark, Object, TimeSpan) |
Запускает операцию для возобновления указанной закладки, используя указанное значение и интервал времени ожидания. Закладка, с которой будет продолжено чтение, ранее создавалась действием в экземпляре рабочего процесса. |
ResumeBookmark(Bookmark, Object) |
Запускает операцию для возобновления указанной закладки, используя указанное значение. Закладка, с которой будет продолжено чтение, ранее создавалась действием в экземпляре рабочего процесса. |
ResumeBookmark(String, Object) |
Запускает операцию для возобновления закладки с указанным именем, используя указанное значение. Закладка, с которой будет продолжено чтение, ранее создавалась действием в экземпляре рабочего процесса. |
ResumeBookmark(String, Object, TimeSpan)
Запускает операцию для возобновления закладки с указанным именем, используя указанное значение и интервал времени ожидания. Закладка, с которой будет продолжено чтение, ранее создавалась действием в экземпляре рабочего процесса.
public:
System::Activities::BookmarkResumptionResult ResumeBookmark(System::String ^ bookmarkName, System::Object ^ value, TimeSpan timeout);
public System.Activities.BookmarkResumptionResult ResumeBookmark (string bookmarkName, object value, TimeSpan timeout);
member this.ResumeBookmark : string * obj * TimeSpan -> System.Activities.BookmarkResumptionResult
Public Function ResumeBookmark (bookmarkName As String, value As Object, timeout As TimeSpan) As BookmarkResumptionResult
Параметры
- bookmarkName
- String
Имя закладки, с которой будет продолжено чтение.
- value
- Object
Объект, передаваемый в качестве параметра методу, вызываемому при возобновлении чтения с закладки.
- timeout
- TimeSpan
Временной интервал, в течение которого чтение с закладки должно быть возобновлено.
Возвращаемое значение
Результат операции возобновления чтения с закладки.
Примеры
В следующем примере создается рабочий процесс, который использует действие ReadLine
, создающее Bookmark. Рабочий процесс запускается, и после создания Bookmark и перехода рабочего процесса в состояние бездействия запрашивается действие пользователя и возобновляется закладка.
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);
}
Variable<string> name = new Variable<string>();
Activity wf = new Sequence
{
Variables = { name },
Activities =
{
new WriteLine
{
Text = "What is your name?"
},
new ReadLine
{
BookmarkName = "UserName",
Result = new OutArgument<string>(name)
},
new WriteLine
{
Text = new InArgument<string>((env) =>
("Hello, " + name.Get(env)))
}
}
};
// Create a WorkflowApplication instance.
WorkflowApplication wfApp = new WorkflowApplication(wf);
// Workflow lifecycle events omitted except idle.
AutoResetEvent idleEvent = new AutoResetEvent(false);
wfApp.Idle = delegate(WorkflowApplicationIdleEventArgs e)
{
idleEvent.Set();
};
// Run the workflow.
wfApp.Run();
// Wait for the workflow to go idle before gathering
// the user's input.
idleEvent.WaitOne();
// Gather the user's input 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.
BookmarkResumptionResult result = wfApp.ResumeBookmark("UserName",
Console.ReadLine());
// Possible BookmarkResumptionResult values:
// Success, NotFound, or NotReady
Console.WriteLine("BookmarkResumptionResult: {0}", result);
Комментарии
Результат по закладке показывает, была ли операция возобновления успешной, либо она завершилась с ошибками.
Применяется к
ResumeBookmark(Bookmark, Object, TimeSpan)
Запускает операцию для возобновления указанной закладки, используя указанное значение и интервал времени ожидания. Закладка, с которой будет продолжено чтение, ранее создавалась действием в экземпляре рабочего процесса.
public:
System::Activities::BookmarkResumptionResult ResumeBookmark(System::Activities::Bookmark ^ bookmark, System::Object ^ value, TimeSpan timeout);
public System.Activities.BookmarkResumptionResult ResumeBookmark (System.Activities.Bookmark bookmark, object value, TimeSpan timeout);
member this.ResumeBookmark : System.Activities.Bookmark * obj * TimeSpan -> System.Activities.BookmarkResumptionResult
Public Function ResumeBookmark (bookmark As Bookmark, value As Object, timeout As TimeSpan) As BookmarkResumptionResult
Параметры
- bookmark
- Bookmark
Возобновляемая закладка.
- value
- Object
Объект, передаваемый в качестве параметра методу, вызываемому при возобновлении чтения с закладки.
- timeout
- TimeSpan
Временной интервал, в течение которого чтение с закладки должно быть возобновлено.
Возвращаемое значение
Результат операции возобновления чтения с закладки.
Примеры
В следующем примере создается рабочий процесс, который использует действие ReadLine
, создающее Bookmark. Рабочий процесс запускается, и после создания Bookmark и перехода рабочего процесса в состояние бездействия запрашивается действие пользователя и возобновляется закладка.
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);
}
Variable<string> name = new Variable<string>();
Activity wf = new Sequence
{
Variables = { name },
Activities =
{
new WriteLine
{
Text = "What is your name?"
},
new ReadLine
{
BookmarkName = "UserName",
Result = new OutArgument<string>(name)
},
new WriteLine
{
Text = new InArgument<string>((env) =>
("Hello, " + name.Get(env)))
}
}
};
// Create a WorkflowApplication instance.
WorkflowApplication wfApp = new WorkflowApplication(wf);
// Workflow lifecycle events omitted except idle.
AutoResetEvent idleEvent = new AutoResetEvent(false);
wfApp.Idle = delegate(WorkflowApplicationIdleEventArgs e)
{
idleEvent.Set();
};
// Run the workflow.
wfApp.Run();
// Wait for the workflow to go idle before gathering
// the user's input.
idleEvent.WaitOne();
// Gather the user's input and resume the bookmark.
BookmarkResumptionResult result = wfApp.ResumeBookmark(new Bookmark("UserName"),
Console.ReadLine(), TimeSpan.FromSeconds(15));
// Possible BookmarkResumptionResult values:
// Success, NotFound, or NotReady
Console.WriteLine("BookmarkResumptionResult: {0}", result);
Комментарии
Результат по закладке показывает, была ли операция возобновления успешной, либо она завершилась с ошибками.
Применяется к
ResumeBookmark(Bookmark, Object)
Запускает операцию для возобновления указанной закладки, используя указанное значение. Закладка, с которой будет продолжено чтение, ранее создавалась действием в экземпляре рабочего процесса.
public:
System::Activities::BookmarkResumptionResult ResumeBookmark(System::Activities::Bookmark ^ bookmark, System::Object ^ value);
public System.Activities.BookmarkResumptionResult ResumeBookmark (System.Activities.Bookmark bookmark, object value);
member this.ResumeBookmark : System.Activities.Bookmark * obj -> System.Activities.BookmarkResumptionResult
Public Function ResumeBookmark (bookmark As Bookmark, value As Object) As BookmarkResumptionResult
Параметры
- bookmark
- Bookmark
Возобновляемая закладка.
- value
- Object
Объект, передаваемый в качестве параметра методу, вызываемому при возобновлении чтения с закладки.
Возвращаемое значение
Результат операции возобновления чтения с закладки.
Примеры
В следующем примере создается рабочий процесс, который использует действие ReadLine
, создающее Bookmark. Рабочий процесс запускается, и после создания Bookmark и перехода рабочего процесса в состояние бездействия запрашивается действие пользователя и возобновляется закладка.
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);
}
Variable<string> name = new Variable<string>();
Activity wf = new Sequence
{
Variables = { name },
Activities =
{
new WriteLine
{
Text = "What is your name?"
},
new ReadLine
{
BookmarkName = "UserName",
Result = new OutArgument<string>(name)
},
new WriteLine
{
Text = new InArgument<string>((env) =>
("Hello, " + name.Get(env)))
}
}
};
// Create a WorkflowApplication instance.
WorkflowApplication wfApp = new WorkflowApplication(wf);
// Workflow lifecycle events omitted except idle.
AutoResetEvent idleEvent = new AutoResetEvent(false);
wfApp.Idle = delegate(WorkflowApplicationIdleEventArgs e)
{
idleEvent.Set();
};
// Run the workflow.
wfApp.Run();
// Wait for the workflow to go idle before gathering
// the user's input.
idleEvent.WaitOne();
// Gather the user's input and resume the bookmark.
BookmarkResumptionResult result = wfApp.ResumeBookmark(new Bookmark("UserName"),
Console.ReadLine());
// Possible BookmarkResumptionResult values:
// Success, NotFound, or NotReady
Console.WriteLine("BookmarkResumptionResult: {0}", result);
Комментарии
Результат по закладке показывает, была ли операция возобновления успешной, либо она завершилась с ошибками.
Применяется к
ResumeBookmark(String, Object)
Запускает операцию для возобновления закладки с указанным именем, используя указанное значение. Закладка, с которой будет продолжено чтение, ранее создавалась действием в экземпляре рабочего процесса.
public:
System::Activities::BookmarkResumptionResult ResumeBookmark(System::String ^ bookmarkName, System::Object ^ value);
public System.Activities.BookmarkResumptionResult ResumeBookmark (string bookmarkName, object value);
member this.ResumeBookmark : string * obj -> System.Activities.BookmarkResumptionResult
Public Function ResumeBookmark (bookmarkName As String, value As Object) As BookmarkResumptionResult
Параметры
- bookmarkName
- String
Имя закладки, с которой будет продолжено чтение.
- value
- Object
Объект, передаваемый в качестве параметра методу, вызываемому при возобновлении чтения с закладки.
Возвращаемое значение
Результат операции возобновления чтения с закладки.
Примеры
В следующем примере создается рабочий процесс, который использует действие ReadLine
, создающее Bookmark. Рабочий процесс запускается, и после создания Bookmark и перехода рабочего процесса в состояние бездействия запрашивается действие пользователя и возобновляется закладка.
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);
}
Variable<string> name = new Variable<string>();
Activity wf = new Sequence
{
Variables = { name },
Activities =
{
new WriteLine
{
Text = "What is your name?"
},
new ReadLine
{
BookmarkName = "UserName",
Result = new OutArgument<string>(name)
},
new WriteLine
{
Text = new InArgument<string>((env) =>
("Hello, " + name.Get(env)))
}
}
};
// Create a WorkflowApplication instance.
WorkflowApplication wfApp = new WorkflowApplication(wf);
// Workflow lifecycle events omitted except idle.
AutoResetEvent idleEvent = new AutoResetEvent(false);
wfApp.Idle = delegate(WorkflowApplicationIdleEventArgs e)
{
idleEvent.Set();
};
// Run the workflow.
wfApp.Run();
// Wait for the workflow to go idle before gathering
// the user's input.
idleEvent.WaitOne();
// Gather the user's input 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.
BookmarkResumptionResult result = wfApp.ResumeBookmark("UserName",
Console.ReadLine());
// Possible BookmarkResumptionResult values:
// Success, NotFound, or NotReady
Console.WriteLine("BookmarkResumptionResult: {0}", result);
Комментарии
Результат по закладке показывает, была ли операция возобновления успешной, либо она завершилась с ошибками.