Yer imleri

Yer işaretleri, bir etkinliğin işlem iş parçacığını tutmadan pasif olarak girişi beklemesini sağlayan mekanizmadır. Bir etkinlik bir uyarıcı beklediğini belirttiğinde, bir yer işareti oluşturabilir. Bu, çalışma zamanına, Bookmark'yi oluşturan şu anda yürütülen yöntem döndüğünde bile etkinliğin yürütülmesinin tamamlanmış 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 yeniden başlatılmasından dış (barındırıcı veya uzantı) kodu sorumludur. Bir Bookmark sürdürülürken, iş akışı çalışma zamanı, oluşturulduğu sırada o BookmarkCallback ile ilişkilendirilen Bookmark temsilciyi zamanlar.

Yer İşaretleri Seçenekleri

BookmarkOptions sınıfı, oluşturulmakta olan Bookmark türünü belirtir. Birbirini dışlamayan olası değerler , Noneve MultipleResumeşeklindedirNonBlocking. NoneTam olarak bir kez sürdürülecek bir Bookmark oluşturma işlemi oluştururken varsayılan olarak kullanın. Kullanın MultipleResume, birden çok kez sürdürülebilecek bir Bookmark oluştururken. Hiçbir zaman sürdürülemeyecek bir NonBlocking oluştururken kullanınBookmark. 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 Bookmark oluşturur, bir geri çağırma kaydeder ve ardından Bookmark'nin devam etmesini bekler. Sürdürülmeye devam edildiğinde, ReadLine etkinliği, Bookmark ile iletilen verileri Result bağımsız değişkenine 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. Ana uygulama, gerçek işlevi olan veriyi toplama işini gerçekleştirir ve devam ettirip iş akışına Bookmark geç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 etkinliği yürütüldüğünde, Bookmark isimli bir UserName oluşturur ve yer işaretinin devam etmesini bekler. Sunucu istenen verileri toplar ve ardından Bookmark devam eder. İş akışı devam eder, adı görüntüler ve ardından tamamlar. Yer işaretini devam ettirmek için eşitleme kodu gerekmediğini unutmayın. Bir Bookmark yalnızca iş akışı boşta olduğunda sürdürülebilir ve iş akışı boşta değilse, ResumeBookmark çağrısı, iş akışı boşta olana kadar engellenir.

Yer İşareti Yeniden Verme Sonucu

ResumeBookmark, yer işareti devam etme isteğinin sonuçlarını göstermek için BookmarkResumptionResult numaralandırma değeri döndürür. Olası dönüş değerleri , Successve NotReadyşeklindedirNotFound. Ana bilgisayarlar ve eklentiler, nasıl ilerleyeceğini belirlemek için bu değeri kullanabilir.