Yer işaretleri
Yer işaretleri, bir etkinliğin bir iş akışı iş parçacığını tutmadan pasif olarak girişi beklemesini sağlayan mekanizmadır. Bir etkinlik uyaran beklediğine işaret ettiğinde, bir yer işareti oluşturabilir. Bu, çalışma zamanına, şu anda yürütülen yöntem (öğesini oluşturan) döndürdüğünde bile etkinliğin yürütülmesinin Bookmarktamamlanmış olarak kabul edilmemesi gerektiğini gösterir.
Yer İşareti Temelleri
A Bookmark , bir iş akışı örneği içinde yürütmenin sürdürülebileceği (ve girişin teslim edilebileceği) bir noktayı temsil eder. Genellikle bir Bookmark ad verilir ve yer işaretinin ilgili verilerle devam ettirilmesinden dış (konak veya uzantı) kodu sorumludur. bir Bookmark sürdürülürken, iş akışı çalışma zamanı oluşturulduğu sırada kendisiyle Bookmark ilişkilendirilmiş temsilciyi zamanlarBookmarkCallback.
Yer İşareti Seçenekleri
BookmarkOptions sınıfı, oluşturulmakta olan türünü Bookmark belirtir. Birbirini dışlamayan olası değerler , MultipleResumeve NonBlockingşeklindedirNone. NoneTam olarak bir kez sürdürülecek bir Bookmark oluşturma işlemi oluştururken varsayılan olarak kullanın. Birden çok kez sürdürülebilecek bir Bookmark oluştururken kullanınMultipleResume. Hiçbir zaman sürdürülemeyecek bir Bookmark oluştururken kullanınNonBlocking. Varsayılan BookmarkOptionskullanılarak oluşturulan yer işaretlerinden farklı olarak, NonBlocking yer işaretleri bir etkinliğin tamamlanmasını engellemez.
Yer İşareti Yeniden Verme
Yer işaretleri, aşırı yüklemelerden biri ResumeBookmark kullanılarak iş akışının dışındaki kodlarla sürdürülebilir. Bu örnekte bir ReadLine
etkinlik oluşturulur. Yürütülürken, ReadLine
etkinlik bir Bookmarkoluşturur, bir geri çağırma kaydeder ve ardından sürdürülmesini Bookmark bekler. Devam ettirildiğinde, ReadLine
etkinlik ile geçirilen Bookmark verileri bağımsız değişkenine Result atar.
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);
}
}
Bu örnekte, kullanıcının adını toplamak ve konsol penceresinde görüntülemek için etkinliği kullanan ReadLine
bir iş akışı oluşturulur. Konak uygulaması, girişi toplama işleminin gerçek çalışmasını gerçekleştirir ve öğesini devam ettirerek iş akışına Bookmarkgeçirir.
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
Etkinlik yürütülürken, bir Bookmark adlandırılmış UserName
oluşturur ve yer işaretinin sürdürülmesini bekler. Konak istenen verileri toplar ve ardından öğesini sürdürür Bookmark. İş akışı devam eder, adı görüntüler ve ardından tamamlar. Yer işaretinin devamı için eşitleme kodu gerekmediğini unutmayın. , Bookmark yalnızca iş akışı boşta olduğunda sürdürülebilir ve iş akışı boşta değilse, iş akışı boşta olana kadar çağrısı ResumeBookmark engellenir.
Yer İşareti Yeniden Verme Sonucu
ResumeBookmark , yer işareti yeniden sağlama isteğinin sonuçlarını göstermek için bir BookmarkResumptionResult numaralandırma değeri döndürür. Olası dönüş değerleri , NotReadyve NotFoundşeklindedirSuccess. Konaklar ve uzantılar, nasıl devam edileceğini belirlemek için bu değeri kullanabilir.