Pick Class

.NET Framework (current version)

Note
The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Provides event-based control flow modeling.

Namespace: System.Activities.Statements
Assembly: System.Activities (in System.Activities.dll)

Inheritance Hierarchy

System.Object
System.Activities.Activity
System.Activities.NativeActivity
System.Activities.Statements.Pick

Syntax

C++

<ContentPropertyAttribute("Branches")>
Public NotInheritable Class Pick
	Inherits NativeActivity

Constructors

	Name	Description
	Pick()	Creates a new instance of the Pick class.

Properties

	Name	Description
	Branches	The collection of PickBranch objects that the Pick activity potentially executes one of, based on incoming events.
	CacheId	Gets the identifier of the cache that is unique within the scope of the workflow definition.(Inherited from Activity.)
	DisplayName	Gets or sets an optional friendly name that is used for debugging, validation, exception handling, and tracking.(Inherited from Activity.)
	Id	Gets an identifier that is unique in the scope of the workflow definition.(Inherited from Activity.)
	ImplementationVersion	Gets or sets the implementation version of the activity.(Inherited from NativeActivity.)

Methods

	Name	Description
	Equals(Object)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	ShouldSerializeDisplayName()	Indicates whether the DisplayName property should be serialized.(Inherited from Activity.)
	ToString()	Returns a String that contains the Id and DisplayName of the Activity.(Inherited from Activity.)

This activity behaves similarly to T:System.Activities.Statements.Switch in that it executes only one of several activities in response to events. The action chosen to be executed is defined by an event, chosen from a set of events.

Examples

The following code sample demonstrates creating a Pick activity. This example is from the Using the Pick Activity sample.

static Activity CreateWF()
{
    Variable<string> name = new Variable<string>();
    Sequence body = new Sequence
    {
        Variables = { name },
        Activities = 
        {
            new WriteLine { Text = "What is your name? (You have 5 seconds to answer)" },
            new Pick
            {
               Branches = 
               {
                   new PickBranch
                    {
                       Trigger = new ReadString
                       {
                           Result = name,
                           BookmarkName = bookmarkName
                       },
                       Action = new WriteLine 
                       { 
                           Text = new InArgument<string>(env => "Hello " + name.Get(env)) 
                       }
                   },
                   new PickBranch
                    {
                       Trigger = new Delay
                       {
                           Duration = TimeSpan.FromSeconds(5)
                       },
                       Action = new WriteLine
                       {
                           Text = "Time is up."
                       }
                   }
               }
           }
       }
    };

    return body;
}

Version Information

.NET Framework
Available since 4.0

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.