Bookmark Classe

Définition

Espace de noms:

System.Activities

Assembly:

System.Activities.dll

Représente un point auquel un flux de travail ou une activité peut attendre passivement avant d'être repris.

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)

Héritage

Object

Bookmark

Attributs

DataContractAttribute

Implémente

IEquatable<Bookmark>

Exemples

Dans l'exemple suivant, une activité ReadLine est créée. Lors de l'exécution, l'activité ReadLine crée un Bookmark, inscrit un rappel, puis attend la reprise du Bookmark. Lors de la reprise, l'activité ReadLine affecte les données passées avec le Bookmark à son argument 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);  
    }  
}  

Dans l’exemple suivant, un workflow est créé qui utilise l’activité ReadLine pour collecter le nom de l’utilisateur et l’afficher dans la fenêtre de console. L'application hôte se charge de rassembler l'ensemble de ces entrées et de les transmettre au workflow en reprenant le 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();  

Lorsque l'activité ReadLine est exécutée, elle crée un Bookmark nommé UserName, puis attend la reprise du signet. L'hôte recueille les données voulues, puis reprend le Bookmark. Le workflow reprend, affiche le nom, puis se termine. Notez qu'aucun code de synchronisation n'est obligatoire pour la reprise du signet. Un Bookmark peut être continué uniquement lorsque le workflow est inactif, et si le workflow n'est pas inactif, l'appel aux blocs ResumeBookmark jusqu'à ce que le workflow devienne inactif.

Remarques

Lorsqu'une activité crée un Bookmark, elle devient inactive et attend la reprise de Bookmark. S'il existe d'autres activités parallèles à l'activité qui crée le Bookmark, elles seront planifiées pour l'exécution.

Les signets peuvent être repris par l'application hôte à l'aide de l'une des surcharges ResumeBookmark.

Pour plus d’informations sur les signets, consultez Utilisation de WorkflowInvoker et WorkflowApplication et Signets.

Constructeurs

Bookmark(String)

Initialise une nouvelle instance de la classe Bookmark avec le nom spécifié.

Propriétés

Name	Obtient le nom du signet.

Méthodes

Equals(Bookmark)	Détermine si l'objet Bookmark actuel et l'objet Bookmark spécifié font référence au même point de continuation dans un flux de travail.
Equals(Object)	Détermine si l'objet Bookmark actuel et l'objet spécifié font référence au même point de continuation dans un flux de travail.
GetHashCode()	Retourne un identificateur unique pour l'instance Bookmark.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne le nom de signet d'un signet nommé ou l'identificateur de signet d'un signet sans nom.