diff --git a/xml/System.Activities.Expressions/Add`3.xml b/xml/System.Activities.Expressions/Add`3.xml
index 224d9f3e2be..ded73372698 100644
--- a/xml/System.Activities.Expressions/Add`3.xml
+++ b/xml/System.Activities.Expressions/Add`3.xml
@@ -104,11 +104,11 @@
if the addition executes in a checked context; otherwise, . The default is .
- activity executes in a checked context and throws an if the addition causes an overflow.
-
+ activity executes in a checked context and throws an if the addition causes an overflow.
+
]]>
diff --git a/xml/System.Activities.Expressions/Cast`2.xml b/xml/System.Activities.Expressions/Cast`2.xml
index 00fabb1b6f6..ee9ef26bf87 100644
--- a/xml/System.Activities.Expressions/Cast`2.xml
+++ b/xml/System.Activities.Expressions/Cast`2.xml
@@ -102,11 +102,11 @@
if the cast operation executes in a checked context; otherwise, . The default is .
- activity executes in a checked context and throws an if the cast operation causes an overflow.
-
+ activity executes in a checked context and throws an if the cast operation causes an overflow.
+
]]>
diff --git a/xml/System.Activities.Expressions/ExpressionServices.xml b/xml/System.Activities.Expressions/ExpressionServices.xml
index b25ab0fccc0..4de7ee34a41 100644
--- a/xml/System.Activities.Expressions/ExpressionServices.xml
+++ b/xml/System.Activities.Expressions/ExpressionServices.xml
@@ -16,103 +16,103 @@
A transformation API used to convert environment aware expressions to an activity tree.
- are designed to work with variables and constants defined inside the workflow, or passed into the workflow via arguments.
-
-
-
-## Examples
- The following code example calls to compute the sum of the array element at index 0 and the array element at index 1. Next, the resulting sum is assigned to a variable and is printed to the console.
-
-```csharp
-
-public static void ComputeSumWithConvert()
-{
- var arrayvar = new Variable("arrayvar", new int[] { 1, 2 });
- var intvar = new Variable("intvar");
-
- // Use ExpressionServices.Convert() to convert the composite lambda expression
- // that represents the sum of array elements at index 0 and 1.
- Activity activity1 = ExpressionServices.Convert(ctx => arrayvar.Get(ctx)[0] + arrayvar.Get(ctx)[1]);
-
- Activity seq = new Sequence
- {
- Variables = { arrayvar, intvar },
- Activities =
- {
- // Get the sum value.
- new Assign
- {
- To = intvar,
- Value = activity1,
- },
- // Print the sum value of 3 to the console.
- new WriteLine
- {
- Text = new InArgument(ctx => intvar.Get(ctx).ToString()),
- },
- }
- };
-
- WorkflowInvoker.Invoke(seq);
-
-}
-
-```
-
- The following code example is provided for comparison purposes. This second example shows how to compute the sum by instantiating the expression activity. The two examples are functionally equivalent but as you can see the second approach involves more coding and is not as straightforward as calling . Therefore the first example is recommended.
-
-```csharp
-
-public static void ComputeSumWithExpressionActivity()
-{
- var arrayvar = new Variable("arrayvar", new int[] { 1, 2 });
- var intvar = new Variable("intvar");
-
- // Create an Add activity to compute the sum of array elements at index 0 and 1.
- Activity activity1 = new Add
- {
- Left = new ArrayItemValue
- {
- Array = arrayvar,
- Index = 0,
- },
- Right = new ArrayItemValue
- {
- Array = arrayvar,
- Index = 1,
- }
- };
-
- Activity seq = new Sequence
- {
- Variables = { arrayvar, intvar },
- Activities =
- {
- // Get the sum value.
- new Assign
- {
- To = intvar,
- Value = activity1,
- },
- // Print the sum value of 3 to the console.
- new WriteLine
- {
- Text = new InArgument(ctx => intvar.Get(ctx).ToString()),
- },
- }
- };
-
- WorkflowInvoker.Invoke(seq);
-
-}
-
-```
-
+ are designed to work with variables and constants defined inside the workflow, or passed into the workflow via arguments.
+
+
+
+## Examples
+ The following code example calls to compute the sum of the array element at index 0 and the array element at index 1. Next, the resulting sum is assigned to a variable and is printed to the console.
+
+```csharp
+
+public static void ComputeSumWithConvert()
+{
+ var arrayvar = new Variable("arrayvar", new int[] { 1, 2 });
+ var intvar = new Variable("intvar");
+
+ // Use ExpressionServices.Convert() to convert the composite lambda expression
+ // that represents the sum of array elements at index 0 and 1.
+ Activity activity1 = ExpressionServices.Convert(ctx => arrayvar.Get(ctx)[0] + arrayvar.Get(ctx)[1]);
+
+ Activity seq = new Sequence
+ {
+ Variables = { arrayvar, intvar },
+ Activities =
+ {
+ // Get the sum value.
+ new Assign
+ {
+ To = intvar,
+ Value = activity1,
+ },
+ // Print the sum value of 3 to the console.
+ new WriteLine
+ {
+ Text = new InArgument(ctx => intvar.Get(ctx).ToString()),
+ },
+ }
+ };
+
+ WorkflowInvoker.Invoke(seq);
+
+}
+
+```
+
+ The following code example is provided for comparison purposes. This second example shows how to compute the sum by instantiating the expression activity. The two examples are functionally equivalent but as you can see the second approach involves more coding and is not as straightforward as calling . Therefore the first example is recommended.
+
+```csharp
+
+public static void ComputeSumWithExpressionActivity()
+{
+ var arrayvar = new Variable("arrayvar", new int[] { 1, 2 });
+ var intvar = new Variable("intvar");
+
+ // Create an Add activity to compute the sum of array elements at index 0 and 1.
+ Activity activity1 = new Add
+ {
+ Left = new ArrayItemValue
+ {
+ Array = arrayvar,
+ Index = 0,
+ },
+ Right = new ArrayItemValue
+ {
+ Array = arrayvar,
+ Index = 1,
+ }
+ };
+
+ Activity seq = new Sequence
+ {
+ Variables = { arrayvar, intvar },
+ Activities =
+ {
+ // Get the sum value.
+ new Assign
+ {
+ To = intvar,
+ Value = activity1,
+ },
+ // Print the sum value of 3 to the console.
+ new WriteLine
+ {
+ Text = new InArgument(ctx => intvar.Get(ctx).ToString()),
+ },
+ }
+ };
+
+ WorkflowInvoker.Invoke(seq);
+
+}
+
+```
+
]]>
@@ -144,13 +144,13 @@ public static void ComputeSumWithExpressionActivity()
Converts a workflow environment-aware expression to an activity tree.
The converted expression.
- , see .
-
- The conversion methods in are designed to work with variables and constants defined inside the workflow, or passed into the workflow via arguments.
-
+ , see .
+
+ The conversion methods in are designed to work with variables and constants defined inside the workflow, or passed into the workflow via arguments.
+
]]>
@@ -182,90 +182,90 @@ public static void ComputeSumWithExpressionActivity()
Converts a reference to a workflow environment-aware expression to an activity tree.
The converted expression.
- are designed to work with variables and constants defined inside the workflow, or passed into the workflow via arguments.
-
-
-
-## Examples
- The following two code examples illustrate the use of and . The first code example uses in an `Assign` activity to convert a lambda expression into a string property that is assigned a value. Next, is called to convert a lambda expression into a string property value that is printed to the console in the `WriteLine` activity.
-
-```csharp
-
-// Define a struct with a property named AProperty.
-struct StructWithProperty
-{
- public string AProperty { get; set; }
-}
-
-public static void ConvertReferenceForValueTypePropertyReferenceSample()
-{
- // Create a variable of type StructWithProperty to store the property.
- var swpvar = new Variable("swpvar", new StructWithProperty());
-
- Activity myActivity = new Sequence
- {
- Variables = { swpvar },
- Activities =
- {
- // Create an Assign activity to assign a value to the AProperty property.
- new Assign
- {
- To = ExpressionServices.ConvertReference(ctx => swpvar.Get(ctx).AProperty),
- // Assign a string literal to AProperty.
- Value = "Hello",
- },
- // Print the new property value to the console.
- new WriteLine()
- {
- Text = ExpressionServices.Convert(ctx => swpvar.Get(ctx).AProperty),
- }
- }
- };
-
- // Invoke the Sequence activity.
- WorkflowInvoker.Invoke(myActivity);
-}
-
-```
-
- The following code example is like the previous one except that the expression to convert is a reference to an item in a multidimensional array.
-
-```csharp
-
-public static void ConvertReferenceForMultidimensionalArrayItemReferenceSample()
-{
- // Create a variable to store a multidimensional array.
- var arrayvar = new Variable("arrayvar", new int[4, 5]);
-
- Activity myActivity = new Sequence
- {
- Variables = { arrayvar },
- Activities =
- {
- // Create an Assign activity to assign a value to the array item at index [1,2].
- new Assign
- {
- To = ExpressionServices.ConvertReference(ctx => arrayvar.Get(ctx)[1, 2]),
- // Assign an integer value to the array item at row 1 column 2.
- Value = 1,
- },
- // Print the array item value to the console.
- new WriteLine()
- {
- Text = ExpressionServices.Convert(ctx => arrayvar.Get(ctx)[1, 2].ToString()),
- }
- }
- };
-
- // Invoke the Sequence activity.
- WorkflowInvoker.Invoke(myActivity);
-}
-
-```
-
+ are designed to work with variables and constants defined inside the workflow, or passed into the workflow via arguments.
+
+
+
+## Examples
+ The following two code examples illustrate the use of and . The first code example uses in an `Assign` activity to convert a lambda expression into a string property that is assigned a value. Next, is called to convert a lambda expression into a string property value that is printed to the console in the `WriteLine` activity.
+
+```csharp
+
+// Define a struct with a property named AProperty.
+struct StructWithProperty
+{
+ public string AProperty { get; set; }
+}
+
+public static void ConvertReferenceForValueTypePropertyReferenceSample()
+{
+ // Create a variable of type StructWithProperty to store the property.
+ var swpvar = new Variable("swpvar", new StructWithProperty());
+
+ Activity myActivity = new Sequence
+ {
+ Variables = { swpvar },
+ Activities =
+ {
+ // Create an Assign activity to assign a value to the AProperty property.
+ new Assign
+ {
+ To = ExpressionServices.ConvertReference(ctx => swpvar.Get(ctx).AProperty),
+ // Assign a string literal to AProperty.
+ Value = "Hello",
+ },
+ // Print the new property value to the console.
+ new WriteLine()
+ {
+ Text = ExpressionServices.Convert(ctx => swpvar.Get(ctx).AProperty),
+ }
+ }
+ };
+
+ // Invoke the Sequence activity.
+ WorkflowInvoker.Invoke(myActivity);
+}
+
+```
+
+ The following code example is like the previous one except that the expression to convert is a reference to an item in a multidimensional array.
+
+```csharp
+
+public static void ConvertReferenceForMultidimensionalArrayItemReferenceSample()
+{
+ // Create a variable to store a multidimensional array.
+ var arrayvar = new Variable("arrayvar", new int[4, 5]);
+
+ Activity myActivity = new Sequence
+ {
+ Variables = { arrayvar },
+ Activities =
+ {
+ // Create an Assign activity to assign a value to the array item at index [1,2].
+ new Assign
+ {
+ To = ExpressionServices.ConvertReference(ctx => arrayvar.Get(ctx)[1, 2]),
+ // Assign an integer value to the array item at row 1 column 2.
+ Value = 1,
+ },
+ // Print the array item value to the console.
+ new WriteLine()
+ {
+ Text = ExpressionServices.Convert(ctx => arrayvar.Get(ctx)[1, 2].ToString()),
+ }
+ }
+ };
+
+ // Invoke the Sequence activity.
+ WorkflowInvoker.Invoke(myActivity);
+}
+
+```
+
]]>
@@ -300,11 +300,11 @@ public static void ConvertReferenceForMultidimensionalArrayItemReferenceSample()
if the expression can be converted; otherwise, .
- are designed to work with variables and constants defined inside the workflow, or passed into the workflow via arguments.
-
+ are designed to work with variables and constants defined inside the workflow, or passed into the workflow via arguments.
+
]]>
@@ -339,11 +339,11 @@ public static void ConvertReferenceForMultidimensionalArrayItemReferenceSample()
if the expression can be converted; otherwise, .
- are designed to work with variables and constants defined inside the workflow, or passed into the workflow via arguments.
-
+ are designed to work with variables and constants defined inside the workflow, or passed into the workflow via arguments.
+
]]>
diff --git a/xml/System.Activities.Expressions/IndexerReference`2.xml b/xml/System.Activities.Expressions/IndexerReference`2.xml
index 59bc3b9b617..ba1a13eac8d 100644
--- a/xml/System.Activities.Expressions/IndexerReference`2.xml
+++ b/xml/System.Activities.Expressions/IndexerReference`2.xml
@@ -34,10 +34,10 @@
in an `Assign` activity to assign an integer value to the object item at index [1,2] and prints the item value to the console. The `Assign` activity is equivalent to the following statement when using an object that implements an indexer. `myObj[1,2] = 4;` .
+ The following code example uses in an `Assign` activity to assign an integer value to the object item at index [1,2] and prints the item value to the console. The `Assign` activity is equivalent to the following statement when using an object that implements an indexer. `myObj[1,2] = 4;` .
> [!NOTE]
-> Instead of instantiating the l-value expression activity directly, it is strongly recommended that you call , which provides a higher level of abstraction and enables you to implement your workflow more intuitively.
+> Instead of instantiating the l-value expression activity directly, it is strongly recommended that you call , which provides a higher level of abstraction and enables you to implement your workflow more intuitively.
```csharp
@@ -199,7 +199,7 @@ public static void IndexerReferenceSample()
property is read-only, but the items in the collection can be modified and the indices can be changed.
+ The property is read-only, but the items in the collection can be modified and the indices can be changed.
]]>
diff --git a/xml/System.Activities.Expressions/LambdaReference`1.xml b/xml/System.Activities.Expressions/LambdaReference`1.xml
index 5f6d93ec665..82a021651e6 100644
--- a/xml/System.Activities.Expressions/LambdaReference`1.xml
+++ b/xml/System.Activities.Expressions/LambdaReference`1.xml
@@ -33,13 +33,13 @@
The type of value returned by the expression.
Represents a lambda expression used as an l-value, which supports binding of arguments.
- is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
-
- This activity uses the LINQ to Entity provider to evaluate LINQ expressions. Any LINQ expressions used with this activity must be evaluatable by the ADO.Net Entity Data Model. For example, LINQ expressions cannot be used to reference activities, variables, or arguments of the workflow itself.
-
+ is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
+
+ This activity uses the LINQ to Entity provider to evaluate LINQ expressions. Any LINQ expressions used with this activity must be evaluatable by the ADO.Net Entity Data Model. For example, LINQ expressions cannot be used to reference activities, variables, or arguments of the workflow itself.
+
]]>
@@ -115,11 +115,11 @@
This method always returns and is used in conjunction with to provide descriptive error messages when an attempt is made to serialize this activity to XAML.
This method always returns .
- is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
-
+ is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
+
]]>
@@ -150,11 +150,11 @@
Throws a and is used in conjunction with to provide descriptive error messages when an attempt is made to serialize this activity to XAML.
This method throws a when called.
- is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
-
+ is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
+
]]>
diff --git a/xml/System.Activities.Expressions/LambdaSerializationException.xml b/xml/System.Activities.Expressions/LambdaSerializationException.xml
index e0e7fe6a7b7..ce6d9640f73 100644
--- a/xml/System.Activities.Expressions/LambdaSerializationException.xml
+++ b/xml/System.Activities.Expressions/LambdaSerializationException.xml
@@ -22,11 +22,11 @@
The exception that is thrown when a XAML serialization attempt is made on a or .
- and are used for lambda expressions specified in code and are not XAML serializable. If an attempt is made to serialize a workflow that contains a or , a is thrown. If the containing workflow requires XAML serialization, use or , or use to convert the or to a serializable format.
-
+ and are used for lambda expressions specified in code and are not XAML serializable. If an attempt is made to serialize a workflow that contains a or , a is thrown. If the containing workflow requires XAML serialization, use or , or use to convert the or to a serializable format.
+
]]>
diff --git a/xml/System.Activities.Expressions/LambdaValue`1.xml b/xml/System.Activities.Expressions/LambdaValue`1.xml
index d8248d73c53..acc89a0424b 100644
--- a/xml/System.Activities.Expressions/LambdaValue`1.xml
+++ b/xml/System.Activities.Expressions/LambdaValue`1.xml
@@ -33,13 +33,13 @@
The type of value returned by the expression.
Represents a lambda expression used as an r-value, which supports binding of arguments.
- is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
-
- This activity uses the LINQ to Entity provider to evaluate LINQ expressions. Any LINQ expressions used with this activity must be evaluatable by the ADO.Net Entity Data Model. For example, LINQ expressions cannot be used to reference activities, variables, or arguments of the workflow itself.
-
+ is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
+
+ This activity uses the LINQ to Entity provider to evaluate LINQ expressions. Any LINQ expressions used with this activity must be evaluatable by the ADO.Net Entity Data Model. For example, LINQ expressions cannot be used to reference activities, variables, or arguments of the workflow itself.
+
]]>
@@ -115,11 +115,11 @@
This method always returns and is used in conjunction with to provide descriptive error messages when an attempt is made to serialize this activity to XAML.
This method always returns .
- is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
-
+ is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
+
]]>
@@ -150,11 +150,11 @@
Throws a , and is used in conjunction with to provide descriptive error messages when an attempt is made to serialize this activity to XAML.
Throws a when called.
- is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
-
+ is used for lambda expressions specified in code and cannot be serialized to XAML. If an attempt to serialize a workflow that contains a is made, a is thrown. If the containing workflow requires XAML serialization, use or use to convert the to a format that can be serialized.
+
]]>
diff --git a/xml/System.Activities.Expressions/MultidimensionalArrayItemReference`1.xml b/xml/System.Activities.Expressions/MultidimensionalArrayItemReference`1.xml
index 295a216a2cc..93ce8d20dfd 100644
--- a/xml/System.Activities.Expressions/MultidimensionalArrayItemReference`1.xml
+++ b/xml/System.Activities.Expressions/MultidimensionalArrayItemReference`1.xml
@@ -32,10 +32,10 @@
in an `Assign` activity to assign an integer value to the array element at row 1 and column 2 and prints the value of the array element to the console. The `Assign` activity is equivalent to the following statement when using arrays: `array[1, 2] = 1;`.
+ The following code example uses in an `Assign` activity to assign an integer value to the array element at row 1 and column 2 and prints the value of the array element to the console. The `Assign` activity is equivalent to the following statement when using arrays: `array[1, 2] = 1;`.
> [!NOTE]
-> Instead of instantiating the l-value expression activity directly, it is strongly recommended that you call , which provides a higher level of abstraction and enables you to implement your workflow more intuitively.
+> Instead of instantiating the l-value expression activity directly, it is strongly recommended that you call , which provides a higher level of abstraction and enables you to implement your workflow more intuitively.
```csharp
@@ -217,7 +217,7 @@ public static void MultidimensionalArrayItemReferenceSample()
property is read-only, but the items in the collection can be modified and the indices can be changed.
+ The property is read-only, but the items in the collection can be modified and the indices can be changed.
]]>
diff --git a/xml/System.Activities.Expressions/Multiply`3.xml b/xml/System.Activities.Expressions/Multiply`3.xml
index 75b1ddb656e..36938d59799 100644
--- a/xml/System.Activities.Expressions/Multiply`3.xml
+++ b/xml/System.Activities.Expressions/Multiply`3.xml
@@ -104,11 +104,11 @@
if the multiplication executes in a checked context; otherwise, . The default is .
- activity executes in a checked context and throws an if the multiplication causes an overflow.
-
+ activity executes in a checked context and throws an if the multiplication causes an overflow.
+
]]>
diff --git a/xml/System.Activities.Expressions/Subtract`3.xml b/xml/System.Activities.Expressions/Subtract`3.xml
index bfeb2c5af10..d2b421bee46 100644
--- a/xml/System.Activities.Expressions/Subtract`3.xml
+++ b/xml/System.Activities.Expressions/Subtract`3.xml
@@ -104,11 +104,11 @@
if the subtraction executes in a checked context; otherwise, . The default is .
- activity executes in a checked context and throws an if the subtraction causes an overflow.
-
+ activity executes in a checked context and throws an if the subtraction causes an overflow.
+
]]>
diff --git a/xml/System.Activities.Expressions/ValueTypeFieldReference`2.xml b/xml/System.Activities.Expressions/ValueTypeFieldReference`2.xml
index 633e447ec40..1362e44cd13 100644
--- a/xml/System.Activities.Expressions/ValueTypeFieldReference`2.xml
+++ b/xml/System.Activities.Expressions/ValueTypeFieldReference`2.xml
@@ -25,57 +25,57 @@
The field type.
Represents a field on a value type that can be used as an l-value in an expression.
- in an `Assign` activity to assign an integer value to a field and prints the field value to the console. The `Assign` activity is equivalent to the following statement when using the `struct` defined in the following example. `myStructVariable.AField = 1;`.
-
+ in an `Assign` activity to assign an integer value to a field and prints the field value to the console. The `Assign` activity is equivalent to the following statement when using the `struct` defined in the following example. `myStructVariable.AField = 1;`.
+
> [!NOTE]
-> Instead of instantiating the l-value expression activity directly, it is strongly recommended that you call , which provides a higher level of abstraction and enables you to implement your workflow more intuitively.
-
-```csharp
-
-// Define a struct with a field named AField.
-struct StructWithField
-{
- public int AField;
-}
-
-public static void ValueTypeFieldReferenceSample()
-{
- // Create a variable of type StructWithField to store the property.
- var swfvar = new Variable("swfvar", new StructWithField());
-
- Activity myActivity = new Sequence
- {
- Variables = { swfvar },
- Activities =
- {
- // Create an Assign activity to assign a value to the AField field.
- new Assign
- {
- To = new ValueTypeFieldReference()
- {
- OperandLocation = swfvar,
- FieldName = "AField",
- },
- // Assign an integer value to AField.
- Value = 1,
- },
- // Print the new field value to the console.
- new WriteLine()
- {
- Text = ExpressionServices.Convert(ctx => swfvar.Get(ctx).AField.ToString()),
- }
- }
- };
-
- // Invoke the Sequence activity.
- WorkflowInvoker.Invoke(myActivity);
-}
-
-```
-
+> Instead of instantiating the l-value expression activity directly, it is strongly recommended that you call , which provides a higher level of abstraction and enables you to implement your workflow more intuitively.
+
+```csharp
+
+// Define a struct with a field named AField.
+struct StructWithField
+{
+ public int AField;
+}
+
+public static void ValueTypeFieldReferenceSample()
+{
+ // Create a variable of type StructWithField to store the property.
+ var swfvar = new Variable("swfvar", new StructWithField());
+
+ Activity myActivity = new Sequence
+ {
+ Variables = { swfvar },
+ Activities =
+ {
+ // Create an Assign activity to assign a value to the AField field.
+ new Assign
+ {
+ To = new ValueTypeFieldReference()
+ {
+ OperandLocation = swfvar,
+ FieldName = "AField",
+ },
+ // Assign an integer value to AField.
+ Value = 1,
+ },
+ // Print the new field value to the console.
+ new WriteLine()
+ {
+ Text = ExpressionServices.Convert(ctx => swfvar.Get(ctx).AField.ToString()),
+ }
+ }
+ };
+
+ // Invoke the Sequence activity.
+ WorkflowInvoker.Invoke(myActivity);
+}
+
+```
+
]]>
diff --git a/xml/System.Activities.Expressions/ValueTypeIndexerReference`2.xml b/xml/System.Activities.Expressions/ValueTypeIndexerReference`2.xml
index a6ee7b34b48..91fe6747dbc 100644
--- a/xml/System.Activities.Expressions/ValueTypeIndexerReference`2.xml
+++ b/xml/System.Activities.Expressions/ValueTypeIndexerReference`2.xml
@@ -34,10 +34,10 @@
in an `Assign` activity to assign a `string` value to the `struct` element at index 1 and prints the element value to the console. The `Assign` activity is equivalent to the following statement when using the `struct` defined in the following example: `myStructVariable[1] = "Hello";`.
+ The following code example uses in an `Assign` activity to assign a `string` value to the `struct` element at index 1 and prints the element value to the console. The `Assign` activity is equivalent to the following statement when using the `struct` defined in the following example: `myStructVariable[1] = "Hello";`.
> [!NOTE]
-> Instead of instantiating the l-value expression activity directly, it is strongly recommended that you call , which provides a higher level of abstraction and enables you to implement your workflow more intuitively.
+> Instead of instantiating the l-value expression activity directly, it is strongly recommended that you call , which provides a higher level of abstraction and enables you to implement your workflow more intuitively.
```csharp
@@ -195,7 +195,7 @@
property is read-only, but the items in the collection can be modified and the indices can be changed.
+ The property is read-only, but the items in the collection can be modified and the indices can be changed.
]]>
diff --git a/xml/System.Activities.Expressions/ValueTypePropertyReference`2.xml b/xml/System.Activities.Expressions/ValueTypePropertyReference`2.xml
index f45ce265135..bfbcec5808a 100644
--- a/xml/System.Activities.Expressions/ValueTypePropertyReference`2.xml
+++ b/xml/System.Activities.Expressions/ValueTypePropertyReference`2.xml
@@ -25,58 +25,58 @@
The property type.
Represents a property on a value type that can be used as an l-value in an expression.
- in an `Assign` activity to assign a `string` value to a property and prints the property value to the console. The `Assign` activity is equivalent to the following statement when using the `struct` defined in the following example: `myStructVariable.AProperty = "Hello";`.
-
+ in an `Assign` activity to assign a `string` value to a property and prints the property value to the console. The `Assign` activity is equivalent to the following statement when using the `struct` defined in the following example: `myStructVariable.AProperty = "Hello";`.
+
> [!NOTE]
-> Instead of instantiating the l-value expression activity directly, it is strongly recommended that you call , which provides a higher level of abstraction and enables you to implement your workflow more intuitively.
-
-```csharp
-
-// Define a struct with a property named AProperty.
-struct StructWithProperty
-{
- public string AProperty { get; set; }
-}
-
-public static void ValueTypePropertyReferenceSample()
-{
- // Create a variable of type StructWithProperty to store the property.
- var swpvar = new Variable("swpvar", new StructWithProperty());
-
- // Create the top-level activity to be invoked later.
- Activity myActivity = new Sequence
- {
- Variables = { swpvar },
- Activities =
- {
- // Create an Assign activity for a property named AProperty.
- new Assign
- {
- To = new ValueTypePropertyReference
- {
- OperandLocation = swpvar,
- PropertyName = "AProperty",
- },
- // Assign a string literal to AProperty.
- Value = "Hello",
- },
- // Create a WriteLine activity to write the value of AProperty to the console.
- new WriteLine()
- {
- Text = ExpressionServices.Convert(ctx => swpvar.Get(ctx).AProperty),
- }
- }
- };
-
- // Invoke the Sequence activity.
- WorkflowInvoker.Invoke(myActivity);
-}
-
-```
-
+> Instead of instantiating the l-value expression activity directly, it is strongly recommended that you call , which provides a higher level of abstraction and enables you to implement your workflow more intuitively.
+
+```csharp
+
+// Define a struct with a property named AProperty.
+struct StructWithProperty
+{
+ public string AProperty { get; set; }
+}
+
+public static void ValueTypePropertyReferenceSample()
+{
+ // Create a variable of type StructWithProperty to store the property.
+ var swpvar = new Variable("swpvar", new StructWithProperty());
+
+ // Create the top-level activity to be invoked later.
+ Activity myActivity = new Sequence
+ {
+ Variables = { swpvar },
+ Activities =
+ {
+ // Create an Assign activity for a property named AProperty.
+ new Assign
+ {
+ To = new ValueTypePropertyReference
+ {
+ OperandLocation = swpvar,
+ PropertyName = "AProperty",
+ },
+ // Assign a string literal to AProperty.
+ Value = "Hello",
+ },
+ // Create a WriteLine activity to write the value of AProperty to the console.
+ new WriteLine()
+ {
+ Text = ExpressionServices.Convert(ctx => swpvar.Get(ctx).AProperty),
+ }
+ }
+ };
+
+ // Invoke the Sequence activity.
+ WorkflowInvoker.Invoke(myActivity);
+}
+
+```
+
]]>
diff --git a/xml/System.Activities.Expressions/VariableReference`1.xml b/xml/System.Activities.Expressions/VariableReference`1.xml
index 429bb516aac..d1af9ff6ebd 100644
--- a/xml/System.Activities.Expressions/VariableReference`1.xml
+++ b/xml/System.Activities.Expressions/VariableReference`1.xml
@@ -177,7 +177,7 @@
property has been set then the string representation consists of the variable's name; otherwise, it consists of the activity ID and name.
+ If the property has been set then the string representation consists of the variable's name; otherwise, it consists of the activity ID and name.
]]>
diff --git a/xml/System.Activities.Expressions/VariableValue`1.xml b/xml/System.Activities.Expressions/VariableValue`1.xml
index e6b439216c0..658a5c17f98 100644
--- a/xml/System.Activities.Expressions/VariableValue`1.xml
+++ b/xml/System.Activities.Expressions/VariableValue`1.xml
@@ -177,7 +177,7 @@
property has been set then the string representation consists of the variable's name; otherwise, it consists of the activity ID and name.
+ If the property has been set then the string representation consists of the variable's name; otherwise, it consists of the activity ID and name.
]]>
diff --git a/xml/System.Activities.Hosting/WorkflowInstance+WorkflowInstanceControl.xml b/xml/System.Activities.Hosting/WorkflowInstance+WorkflowInstanceControl.xml
index aa1a7d27768..6309293f249 100644
--- a/xml/System.Activities.Hosting/WorkflowInstance+WorkflowInstanceControl.xml
+++ b/xml/System.Activities.Hosting/WorkflowInstance+WorkflowInstanceControl.xml
@@ -25,11 +25,11 @@
Aborts the .
- is called, most APIs except throw an .
-
+ is called, most APIs except throw an .
+
]]>
@@ -53,11 +53,11 @@
Aborts the .
- is called, most APIs except throw an .
-
+ is called, most APIs except throw an .
+
]]>
@@ -84,11 +84,11 @@
The reason for aborting the .
Aborts the using the specified exception.
- is called, most APIs except throw an .
-
+ is called, most APIs except throw an .
+
]]>
@@ -670,11 +670,11 @@
Schedules the cancellation of the .
- .
-
+ .
+
]]>
diff --git a/xml/System.Activities.Hosting/WorkflowInstance.xml b/xml/System.Activities.Hosting/WorkflowInstance.xml
index 1b7337adf65..80f8f1b8efd 100644
--- a/xml/System.Activities.Hosting/WorkflowInstance.xml
+++ b/xml/System.Activities.Hosting/WorkflowInstance.xml
@@ -23,21 +23,21 @@
## Remarks
is single threaded and assumes that the host synchronizes all access to it. An attempt to call multiple APIs simultaneously will result in an being thrown.
- Internally, a has two states: Running and Paused. The only way to cause the runtime to transition from paused to running is to call . All actions (except Pause) can only be taken while the runtime is Paused. The runtime will become spontaneously Paused in the following situations:
+ Internally, a has two states: Running and Paused. The only way to cause the runtime to transition from paused to running is to call . All actions (except Pause) can only be taken while the runtime is Paused. The runtime will become spontaneously Paused in the following situations:
-- An error fatal to the runtime has occurred. The host will be signaled through (which does not signal a transition to Paused) and then notified through .
+- An error fatal to the runtime has occurred. The host will be signaled through (which does not signal a transition to Paused) and then notified through .
-- An exception in the workflow was uncaught and escaped the root. The host will be notified through the method.
+- An exception in the workflow was uncaught and escaped the root. The host will be notified through the method.
-- The scheduler has run out of work items and is now . The host will be notified through the method. Note that the scheduler could have run out of work items because the instance is idle or because the instance is complete. The value of the property can be used to differentiate between the two.
+- The scheduler has run out of work items and is now . The host will be notified through the method. Note that the scheduler could have run out of work items because the instance is idle or because the instance is complete. The value of the property can be used to differentiate between the two.
- The host can request a change from Running to Paused by calling the or methods of the instance returned by the property. This request should not be considered to have a specific response meaning that the host should not attempt to correlate an OnNotify* or with a specific call to pause. In response to a pause request, the runtime may transition to Paused and call while the scheduler still has pending work items. The value of the property can be used to determine whether the scheduler has no more work or was interrupted by a request to pause.
+ The host can request a change from Running to Paused by calling the or methods of the instance returned by the property. This request should not be considered to have a specific response meaning that the host should not attempt to correlate an OnNotify* or with a specific call to pause. In response to a pause request, the runtime may transition to Paused and call while the scheduler still has pending work items. The value of the property can be used to determine whether the scheduler has no more work or was interrupted by a request to pause.
- The method of the instance returned by the property is the only method that can be called while the is in the Running state. All other methods will throw an if called.Given the rules for how transitions from one state to another, the public notion of Running and Paused can be defined as follows:
+ The method of the instance returned by the property is the only method that can be called while the is in the Running state. All other methods will throw an if called.Given the rules for how transitions from one state to another, the public notion of Running and Paused can be defined as follows:
-- Running - The state between a call to and the next WorkflowInstance.OnNotify*.
+- Running - The state between a call to and the next WorkflowInstance.OnNotify*.
-- Paused - The state between the last WorkflowInstance.OnNotify* and the next call to .
+- Paused - The state between the last WorkflowInstance.OnNotify* and the next call to .
]]>
@@ -351,7 +351,7 @@
returns `true`, an is thrown.
+ If this property is set after the workflow instance is initialized and returns `true`, an is thrown.
]]>
@@ -802,7 +802,7 @@
is called, most APIs except will throw an . It is expected that after is called a host will trend toward a state in which it can satisfy the abort.
+ Once is called, most APIs except will throw an . It is expected that after is called a host will trend toward a state in which it can satisfy the abort.
]]>
@@ -833,7 +833,7 @@
use the runtime type of the object as the type key. Extensions providers added through use the decared type T of the Func\ as the type key. Extension providers contributed by activities through the various *ActivityMetadata.AddDefaultExtensionProvider methods are dropped if a host extension exists for the declared type or if there is a broader type provided through AddDefaultExtensionProvider (ex. if Func\ is provided and Func\ is provided, only Func\ will be kept). If an extension does not exist in the collection that is required by an activity (expressed by calling *ActivityMetadata.RequireExtension) a is thrown.
+ Extensions are keyed by type, and a host provided extension will always be used if provided. Extensions added through use the runtime type of the object as the type key. Extensions providers added through use the decared type T of the Func\ as the type key. Extension providers contributed by activities through the various *ActivityMetadata.AddDefaultExtensionProvider methods are dropped if a host extension exists for the declared type or if there is a broader type provided through AddDefaultExtensionProvider (ex. if Func\ is provided and Func\ is provided, only Func\ will be kept). If an extension does not exist in the collection that is required by an activity (expressed by calling *ActivityMetadata.RequireExtension) a is thrown.
]]>
@@ -889,7 +889,7 @@
returns `true`, an is thrown.
+ If this property is set after the workflow instance is initialized and returns `true`, an is thrown.
]]>
@@ -917,7 +917,7 @@
returns `true`, then an is thrown.
+ If returns `true`, then an is thrown.
]]>
diff --git a/xml/System.Activities.Hosting/WorkflowInstanceExtensionManager.xml b/xml/System.Activities.Hosting/WorkflowInstanceExtensionManager.xml
index 58ddf0bc9a6..a2d1970cbda 100644
--- a/xml/System.Activities.Hosting/WorkflowInstanceExtensionManager.xml
+++ b/xml/System.Activities.Hosting/WorkflowInstanceExtensionManager.xml
@@ -63,13 +63,13 @@
The extension to add.
Adds the specified extension to the collection of extensions.
- overload.
-
- If any of the overloads are called after , an is thrown.
-
+ overload.
+
+ If any of the overloads are called after , an is thrown.
+
]]>
@@ -104,13 +104,13 @@
The method that creates the extension.
Registers a that is used to provide an instance of an extension when requested by a workflow instance.
- overload.
-
- If any of the overloads are called after , an is thrown.
-
+ overload.
+
+ If any of the overloads are called after , an is thrown.
+
]]>
@@ -134,11 +134,11 @@
Marks the collection of extensions as read-only.
- overloads are called after , an is thrown.
-
+ overloads are called after , an is thrown.
+
]]>
diff --git a/xml/System.Activities.Hosting/WorkflowInstanceProxy.xml b/xml/System.Activities.Hosting/WorkflowInstanceProxy.xml
index e2a9c9065d2..52c6218ab76 100644
--- a/xml/System.Activities.Hosting/WorkflowInstanceProxy.xml
+++ b/xml/System.Activities.Hosting/WorkflowInstanceProxy.xml
@@ -56,11 +56,11 @@
Resumes a workflow from a bookmark asynchronously using the specified bookmark, value, callback method, and user-provided state data.
A reference to the asynchronous operation.
- . can be called from inside or outside of the callback method. If is called before the resume operation completes, it blocks until the resume operation completes.
-
+ . can be called from inside or outside of the callback method. If is called before the resume operation completes, it blocks until the resume operation completes.
+
]]>
@@ -96,11 +96,11 @@
Resumes a workflow from a bookmark asynchronously using the specified bookmark, value, time-out interval, callback method, and user-provided state.
A reference to the asynchronous operation.
- . can be called from inside or outside of the callback method. If is called before the resume operation completes, it blocks until the resume operation completes. By default, the resume operation must complete in 30 seconds or a is thrown from .
-
+ . can be called from inside or outside of the callback method. If is called before the resume operation completes, it blocks until the resume operation completes. By default, the resume operation must complete in 30 seconds or a is thrown from .
+
]]>
@@ -128,11 +128,11 @@
Waits for the pending asynchronous to complete.
Returns .
- operation was successful. If called before the resume operation completes, it blocks until the resume operation is complete.
-
+ operation was successful. If called before the resume operation completes, it blocks until the resume operation is complete.
+
]]>
diff --git a/xml/System.Activities.Persistence/PersistenceParticipant.xml b/xml/System.Activities.Persistence/PersistenceParticipant.xml
index 1ae66988556..845392836fe 100644
--- a/xml/System.Activities.Persistence/PersistenceParticipant.xml
+++ b/xml/System.Activities.Persistence/PersistenceParticipant.xml
@@ -16,38 +16,38 @@
This class allows both and to participate in persistence process. A persistence participant derives from the class or the class (derived class of the class), implements abstract methods, and then add an instance of the class as a workflow instance extension. The and look for such extensions when persisting an instance and invoke appropriate methods at appropriate times.
- to the persistence provider.
-
-4. Performs I/O under the persistence transaction.
-
- A host completes a stage before beginning the next stage. For example when persisting, the host collects values from all the persistence participants before moving to the second stage. In the second stage, the host provides all the values collected in the first stage to all persistence participants in the second stage for mapping. In the third stage, the host provides all the collected values in the first and second stages to the persistence provider when invoking the . Then in the fourth stage, the host provides all the collected values to all the persistence IO participants under the persistence transaction.
-
- A host executes the following stages when loading a persistence instance:
-
-1. Issues the and to the persistence provider.
-
-2. Performs I/O under the persistence transaction.
-
-3. Publishes the loaded values.
-
- At the highest level, workflow instance extensions that derive from the class can participate in the first (Collect) and second (Map) stages of persisting process and the third stage (Publish) of loading process. Workflow instance extensions deriving from the PersistenceIOParticipant class can additionally participate in the fourth stage of the persisting process and the second stage of the loading process (I/O).
-
-
-
-## Examples
- The following code sample demonstrates creating a class that derives from . This example is from the [Hiring Process](/dotnet/framework/windows-workflow-foundation/samples/hiring-process) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_hiringrequestprocess/cs/hiringrequestservice/hiringrequestpersistenceparticipant.cs" id="Snippet1":::
-
+ to the persistence provider.
+
+4. Performs I/O under the persistence transaction.
+
+ A host completes a stage before beginning the next stage. For example when persisting, the host collects values from all the persistence participants before moving to the second stage. In the second stage, the host provides all the values collected in the first stage to all persistence participants in the second stage for mapping. In the third stage, the host provides all the collected values in the first and second stages to the persistence provider when invoking the . Then in the fourth stage, the host provides all the collected values to all the persistence IO participants under the persistence transaction.
+
+ A host executes the following stages when loading a persistence instance:
+
+1. Issues the and to the persistence provider.
+
+2. Performs I/O under the persistence transaction.
+
+3. Publishes the loaded values.
+
+ At the highest level, workflow instance extensions that derive from the class can participate in the first (Collect) and second (Map) stages of persisting process and the third stage (Publish) of loading process. Workflow instance extensions deriving from the PersistenceIOParticipant class can additionally participate in the fourth stage of the persisting process and the second stage of the loading process (I/O).
+
+
+
+## Examples
+ The following code sample demonstrates creating a class that derives from . This example is from the [Hiring Process](/dotnet/framework/windows-workflow-foundation/samples/hiring-process) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_hiringrequestprocess/cs/hiringrequestservice/hiringrequestpersistenceparticipant.cs" id="Snippet1":::
+
]]>
@@ -73,13 +73,13 @@
Initializes an instance of the class.
- . This example is from the [Hiring Process](/dotnet/framework/windows-workflow-foundation/samples/hiring-process) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_hiringrequestprocess/cs/hiringrequestservice/hiringrequestpersistenceparticipant.cs" id="Snippet1":::
-
+ . This example is from the [Hiring Process](/dotnet/framework/windows-workflow-foundation/samples/hiring-process) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_hiringrequestprocess/cs/hiringrequestservice/hiringrequestpersistenceparticipant.cs" id="Snippet1":::
+
]]>
@@ -108,21 +108,21 @@
The write-only values to be persisted.
A host invokes this method on a custom persistence participant to collect read-write values and write-only values, to be persisted.
- objects of an collection, and packages write-only values in the second dictionary as objects with and flags set. For more information, see .
-
+ objects of an collection, and packages write-only values in the second dictionary as objects with and flags set. For more information, see .
+
> [!IMPORTANT]
-> Each value provided by implementations of across all persistence participants within one persistence episode must have a unique XName.
-
-
-
-## Examples
- The following code sample demonstrates using CollectValues in a class that derives from . This example is from the [Persistence Participants](/dotnet/framework/windows-workflow-foundation/persistence-participants) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_persistenceparticipants/cs/stepcountextension.cs" id="Snippet2":::
-
+> Each value provided by implementations of across all persistence participants within one persistence episode must have a unique XName.
+
+
+
+## Examples
+ The following code sample demonstrates using CollectValues in a class that derives from . This example is from the [Persistence Participants](/dotnet/framework/windows-workflow-foundation/persistence-participants) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_persistenceparticipants/cs/stepcountextension.cs" id="Snippet2":::
+
]]>
@@ -152,18 +152,18 @@
A host invokes this method after it is done with collecting the values in the first stage. The host forwards two read-only dictionaries of values it collected from all persistence participants during the first stage (CollectValues stage) to this method for mapping. The host adds values in the dictionary returned by this method to the collection of write-only values.
A dictionary containing additional write-only values to be persisted.
- methods across all persistence participants including all the values collected in the first stage (CollectValues stage) must have a unique XName.
-
-
-
-## Examples
- The following code sample demonstrates using MapValues in a class that derives from . This example is from the [Corporate Purchase Process](/dotnet/framework/windows-workflow-foundation/samples/corporate-purchase-process) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_purchaseprocess/cs/xmlpersistenceparticipant.cs" id="Snippet2":::
-
+ methods across all persistence participants including all the values collected in the first stage (CollectValues stage) must have a unique XName.
+
+
+
+## Examples
+ The following code sample demonstrates using MapValues in a class that derives from . This example is from the [Corporate Purchase Process](/dotnet/framework/windows-workflow-foundation/samples/corporate-purchase-process) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_purchaseprocess/cs/xmlpersistenceparticipant.cs" id="Snippet2":::
+
]]>
@@ -190,13 +190,13 @@
The read-write values that were loaded from the persistence store. This dictionary corresponds to the dictionary of read-write values persisted in the most recent persistence episode.
The host invokes this method and passes all the loaded values in the collection (filled by the or ) as a dictionary parameter.
- . This example is from the [Persistence Participants](/dotnet/framework/windows-workflow-foundation/persistence-participants) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_persistenceparticipants/cs/stepcountextension.cs" id="Snippet2":::
-
+ . This example is from the [Persistence Participants](/dotnet/framework/windows-workflow-foundation/persistence-participants) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_persistenceparticipants/cs/stepcountextension.cs" id="Snippet2":::
+
]]>
diff --git a/xml/System.Activities.Presentation.Converters/ModelToObjectValueConverter.xml b/xml/System.Activities.Presentation.Converters/ModelToObjectValueConverter.xml
index 22100cbbb2e..bce32b95955 100644
--- a/xml/System.Activities.Presentation.Converters/ModelToObjectValueConverter.xml
+++ b/xml/System.Activities.Presentation.Converters/ModelToObjectValueConverter.xml
@@ -20,11 +20,11 @@
Converts a to the value of the inner object.
-
@@ -118,11 +118,11 @@
Returns the specified value, unmodified.
An object that contains the unmodified value.
- can accept the value without modification.
-
+ can accept the value without modification.
+
]]>
diff --git a/xml/System.Activities.Presentation.Metadata/AttributeCallback.xml b/xml/System.Activities.Presentation.Metadata/AttributeCallback.xml
index 3597e3fdb7e..8d7803c79c2 100644
--- a/xml/System.Activities.Presentation.Metadata/AttributeCallback.xml
+++ b/xml/System.Activities.Presentation.Metadata/AttributeCallback.xml
@@ -22,13 +22,13 @@
An that can be used to add attributes.
Called when attributes are needed for a type.
- method of the class.
-
- objects can build attributes only for the type that is requesting metadata.
-
+ method of the class.
+
+ objects can build attributes only for the type that is requesting metadata.
+
]]>
diff --git a/xml/System.Activities.Presentation.Metadata/AttributeCallbackBuilder.xml b/xml/System.Activities.Presentation.Metadata/AttributeCallbackBuilder.xml
index 0a3fae3801a..e87d1375521 100644
--- a/xml/System.Activities.Presentation.Metadata/AttributeCallbackBuilder.xml
+++ b/xml/System.Activities.Presentation.Metadata/AttributeCallbackBuilder.xml
@@ -16,11 +16,11 @@
Provides access to add attributes for one specific type to one specific .
- is queried for attributes for a type, if the was populated using for that type, the delegate is passed a . The removes the callback reference and adds any attribute information provided by calls to .
-
+ is queried for attributes for a type, if the was populated using for that type, the delegate is passed a . The removes the callback reference and adds any attribute information provided by calls to .
+
]]>
@@ -33,13 +33,13 @@
Adds the contents of the provided attributes to the attribute table that created this builder.
- .
-
+ .
+
]]>
@@ -73,13 +73,13 @@
The attributes that are added to the table.
Adds the contents of the provided attributes to the attribute table that created this builder.
- .
-
+ .
+
]]>
@@ -117,13 +117,13 @@
The attributes that are added to the table.
Adds the contents of the provided attributes to the attribute table that created this builder.
- .
-
+ .
+
]]>
@@ -161,13 +161,13 @@
The attributes that are added to the table.
Adds the contents of the provided attributes to the attribute table that created this builder.
- .
-
+ .
+
]]>
@@ -205,13 +205,13 @@
The attributes that are added to the table.
Adds the contents of the provided attributes to the attribute table that created this builder.
- .
-
+ .
+
]]>
@@ -249,13 +249,13 @@
The attributes that are added to the table.
Adds the contents of the provided attributes to the attribute table that created this builder.
- .
-
+ .
+
]]>
@@ -287,11 +287,11 @@
The type to which attributes will be added.
The type to which attributes will be added.
-
diff --git a/xml/System.Activities.Presentation.Metadata/AttributeTableBuilder.xml b/xml/System.Activities.Presentation.Metadata/AttributeTableBuilder.xml
index a064c894fb4..0c81b093c66 100644
--- a/xml/System.Activities.Presentation.Metadata/AttributeTableBuilder.xml
+++ b/xml/System.Activities.Presentation.Metadata/AttributeTableBuilder.xml
@@ -16,11 +16,11 @@
Creates and populates an that is used by the to provide attribute lookup and registration.
- , , and to populate the builder, then call to acquire an containing the desired collection of attributes.
-
+ , , and to populate the builder, then call to acquire an containing the desired collection of attributes.
+
]]>
@@ -66,11 +66,11 @@
The callback method.
Specifies a callback that will be invoked when metadata for the given type is needed.
- returned by is queried for attributes for `type`, `callback` is called to provide the metadata information.
-
+ returned by is queried for attributes for `type`, `callback` is called to provide the metadata information.
+
]]>
@@ -83,13 +83,13 @@
Adds the contents of the provided attributes to this builder.
- to defer the work of creating attributes until they are needed.
-
+ to defer the work of creating attributes until they are needed.
+
]]>
@@ -125,13 +125,13 @@
The attributes that are added to the builder.
Adds the contents of the provided attributes to this builder.
- to defer the work of creating attributes until they are needed.
-
+ to defer the work of creating attributes until they are needed.
+
]]>
@@ -171,13 +171,13 @@
The attributes that are added to the builder.
Adds the contents of the provided attributes to this builder.
- to defer the work of creating attributes until they are needed.
-
+ to defer the work of creating attributes until they are needed.
+
]]>
@@ -217,13 +217,13 @@
The attributes that are added to the builder.
Adds the contents of the provided attributes to this builder.
- to defer the work of creating attributes until they are needed.
-
+ to defer the work of creating attributes until they are needed.
+
]]>
@@ -263,13 +263,13 @@
The attributes that are added to the builder.
Adds the contents of the provided attributes to this builder.
- to defer the work of creating attributes until they are needed.
-
+ to defer the work of creating attributes until they are needed.
+
]]>
@@ -309,13 +309,13 @@
The attributes that are added to the builder.
Adds the contents of the provided attributes to this builder.
- to defer the work of creating attributes until they are needed.
-
+ to defer the work of creating attributes until they are needed.
+
]]>
@@ -344,11 +344,11 @@
The source attribute table.
Adds the contents of the provided attribute table to this builder.
-
@@ -375,13 +375,13 @@
Creates an attribute table that contains all of the attribute definitions provided through calls.
An that can be passed to the metadata store.
- calls are not included in the table.
-
- If callback methods were used to declare attributes, those methods will not be evaluated during . Instead, the table will contain those callbacks and will evaluate them as needed.
-
+ calls are not included in the table.
+
+ If callback methods were used to declare attributes, those methods will not be evaluated during . Instead, the table will contain those callbacks and will evaluate them as needed.
+
]]>
@@ -405,11 +405,11 @@
Verifies that the attribute table that is being built contains valid attribute information.
- cannot validate that values passed to their parameters represent valid members on classes. verifies that all custom attribute information corresponds to actual members. This method can take a long time to complete and is not recommended unless validation is explicitly needed.
-
+ cannot validate that values passed to their parameters represent valid members on classes. verifies that all custom attribute information corresponds to actual members. This method can take a long time to complete and is not recommended unless validation is explicitly needed.
+
]]>
the state of the table is invalid.
diff --git a/xml/System.Activities.Presentation.Metadata/IRegisterMetadata.xml b/xml/System.Activities.Presentation.Metadata/IRegisterMetadata.xml
index b7e50a4181b..ddabd0b1165 100644
--- a/xml/System.Activities.Presentation.Metadata/IRegisterMetadata.xml
+++ b/xml/System.Activities.Presentation.Metadata/IRegisterMetadata.xml
@@ -13,11 +13,11 @@
Specifies a class that will add extra attributes to the metadata store.
- types provide a way to encapsulate the association of design-time attributes to run-time types in a loosely coupled fashion. An application hosting the Windows Workflow Designer can use the interface to register the attributes for the activity. For instance, Visual Studio 2010 searches for types that implement when assemblies that contain these types are loaded in addition to also looking for types in the *.design assemblies.
-
+ types provide a way to encapsulate the association of design-time attributes to run-time types in a loosely coupled fashion. An application hosting the Windows Workflow Designer can use the interface to register the attributes for the activity. For instance, Visual Studio 2010 searches for types that implement when assemblies that contain these types are loaded in addition to also looking for types in the *.design assemblies.
+
]]>
@@ -41,11 +41,11 @@
Adds additional metadata to the metadata store upon initialization of the designer.
- to add data to the metadata store.
-
+ to add data to the metadata store.
+
]]>
diff --git a/xml/System.Activities.Presentation.Model/AttachedProperty.xml b/xml/System.Activities.Presentation.Model/AttachedProperty.xml
index 87bf605c418..d7213787771 100644
--- a/xml/System.Activities.Presentation.Model/AttachedProperty.xml
+++ b/xml/System.Activities.Presentation.Model/AttachedProperty.xml
@@ -16,11 +16,11 @@
Used in order to associate or attach additional information to the instance of an object.
- is useful as items in the `View` can bind to the values and react to changes. For instance, this is the way that the selected item template is displayed (it keys off of an attached property for selection).
-
+ is useful as items in the `View` can bind to the values and react to changes. For instance, this is the way that the selected item template is displayed (it keys off of an attached property for selection).
+
]]>
@@ -97,11 +97,11 @@
if the is browsable; otherwise, .
- will be discoverable within the collection of the to which it is attached.
-
+ will be discoverable within the collection of the to which it is attached.
+
]]>
diff --git a/xml/System.Activities.Presentation.Model/ModelEditingScope.xml b/xml/System.Activities.Presentation.Model/ModelEditingScope.xml
index 51c289841c6..7241e2a8c64 100644
--- a/xml/System.Activities.Presentation.Model/ModelEditingScope.xml
+++ b/xml/System.Activities.Presentation.Model/ModelEditingScope.xml
@@ -20,11 +20,11 @@
Represents a group of changes to the editing store. Change groups are transactional. The changes made under an editing scope can be committed or aborted as a unit.
- method is called, or the editing scope is disposed of before is called, the editing scope will instead reverse the changes made to the underlying objects, reapplying state from the editing store. This provides a solid basis for an undo mechanism.
-
+ method is called, or the editing scope is disposed of before is called, the editing scope will instead reverse the changes made to the underlying objects, reapplying state from the editing store. This provides a solid basis for an undo mechanism.
+
]]>
@@ -161,11 +161,11 @@
Disposes of this object by aborting changes unless the editing scope has already been completed or reverted.
- with the input parameter set to `true`.
-
+ with the input parameter set to `true`.
+
]]>
@@ -192,11 +192,11 @@
Determines whether the changes should be reverted as part of an undo operation or because the object is being finalized.
Disposes of this object by aborting changes.
- if `disposing` is set to `true`.
-
+ if `disposing` is set to `true`.
+
]]>
@@ -246,11 +246,11 @@
if the exception is handled; otherwise, .
- and methods call this method to handle exceptions.
-
+ and methods call this method to handle exceptions.
+
]]>
@@ -298,11 +298,11 @@
Abandons the changes made during the editing scope.
- with the input parameter set to `false`.
-
+ with the input parameter set to `false`.
+
]]>
The group of changes has already been committed.
diff --git a/xml/System.Activities.Presentation.Model/ModelItem.xml b/xml/System.Activities.Presentation.Model/ModelItem.xml
index e597ae5abe6..e9d88bea663 100644
--- a/xml/System.Activities.Presentation.Model/ModelItem.xml
+++ b/xml/System.Activities.Presentation.Model/ModelItem.xml
@@ -23,12 +23,12 @@
collection and make changes to the values of the properties.
+ You can access the item's properties through its collection and make changes to the values of the properties.
- A is a wrapper around the underlying data model of the designer. You can access the underlying model through the method.
+ A is a wrapper around the underlying data model of the designer. You can access the underlying model through the method.
> [!NOTE]
-> Any changes you make to an object returned from the method will not be reflected by the serialization and undo systems of the designer.
+> Any changes you make to an object returned from the method will not be reflected by the serialization and undo systems of the designer.
@@ -58,7 +58,7 @@ public class Location
```
- Secondly, create an instance of that `Animal` and a that is a proxy for it. The object can then be retrieved by calling . The following code also shows how to use other properties defined by .
+ Secondly, create an instance of that `Animal` and a that is a proxy for it. The object can then be retrieved by calling . The following code also shows how to use other properties defined by .
```csharp
@@ -324,7 +324,7 @@ Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to
method can return either an existing or new cloned instance of the object.
+ You can inspect this object, but you should not make any changes to it. Changes made to the object returned will not be incorporated into the designer. The method can return either an existing or new cloned instance of the object.
]]>
@@ -373,7 +373,7 @@ Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to
on an item. If the of this item declares a `RuntimeNamePropertyAttribute`, the property is a direct mapping to the property dictated by that attribute.
+ Not all items need to have names, so this might return `null`. Depending on the type of item and where it sits in the hierarchy, it might not always be legal to set the on an item. If the of this item declares a `RuntimeNamePropertyAttribute`, the property is a direct mapping to the property dictated by that attribute.
]]>
diff --git a/xml/System.Activities.Presentation.Model/ModelItemCollection.xml b/xml/System.Activities.Presentation.Model/ModelItemCollection.xml
index a63f88c88fd..f1162457c12 100644
--- a/xml/System.Activities.Presentation.Model/ModelItemCollection.xml
+++ b/xml/System.Activities.Presentation.Model/ModelItemCollection.xml
@@ -319,7 +319,7 @@
session. If an object is added to the during a session, the value will not be updated until the session exits.
+ This value is not updated during an session. If an object is added to the during a session, the value will not be updated until the session exits.
]]>
diff --git a/xml/System.Activities.Presentation.Model/ModelProperty.xml b/xml/System.Activities.Presentation.Model/ModelProperty.xml
index f3ca4eb240e..e9a0b48c164 100644
--- a/xml/System.Activities.Presentation.Model/ModelProperty.xml
+++ b/xml/System.Activities.Presentation.Model/ModelProperty.xml
@@ -16,11 +16,11 @@
A represents a property on a . Model properties are associated with an instance of an item, which allows them to have simple Value get/set properties instead of using the more cumbersome GetValue/SetValue mechanism of .
- may come from a locally set value, or it may be inherited from somewhere higher up in the element hierarchy. Use the property of the value returned by to determine the source of the property value.
-
+ may come from a locally set value, or it may be inherited from somewhere higher up in the element hierarchy. Use the property of the value returned by to determine the source of the property value.
+
]]>
@@ -109,11 +109,11 @@
Clears the local value for the property.
- instead.
-
+ instead.
+
]]>
@@ -137,11 +137,11 @@
Returns cast as a .
Returns the property value as a , or .
-
@@ -186,11 +186,11 @@
Returns the type converter to use with this property.
Returns a for use with this property.
- objects. When performing a conversion to a particular value, the type converter's return type is not wrapped. Type converters that return standard values also return values as objects.
-
+ objects. When performing a conversion to a particular value, the type converter's return type is not wrapped. Type converters that return standard values also return values as objects.
+
]]>
@@ -559,14 +559,14 @@
Sets a local value on a property.
Returns as a .
- , it is wrapped in a , which is returned to the caller. It is valid to set `value` to `null`, in which case will be `null`. This is different from calling .
-
+ , it is wrapped in a , which is returned to the caller. It is valid to set `value` to `null`, in which case will be `null`. This is different from calling .
+
> [!NOTE]
-> Using this method, the value will not be set on the underlying property until the editing context completes. To update the underlying property immediately, use .
-
+> Using this method, the value will not be set on the underlying property until the editing context completes. To update the underlying property immediately, use .
+
]]>
@@ -590,11 +590,11 @@
Returns the value set into this property.
Returns the property value as a , or .
- is not `this`. If no value has ever been set for the property will return `null`.
-
+ is not `this`. If no value has ever been set for the property will return `null`.
+
]]>
diff --git a/xml/System.Activities.Presentation.Model/ModelPropertyCollection.xml b/xml/System.Activities.Presentation.Model/ModelPropertyCollection.xml
index 0db5da74aac..7e2f0783156 100644
--- a/xml/System.Activities.Presentation.Model/ModelPropertyCollection.xml
+++ b/xml/System.Activities.Presentation.Model/ModelPropertyCollection.xml
@@ -20,11 +20,11 @@
Contains an enumeration of properties.
- .
-
+ .
+
]]>
diff --git a/xml/System.Activities.Presentation.PropertyEditing/DialogPropertyValueEditor.xml b/xml/System.Activities.Presentation.PropertyEditing/DialogPropertyValueEditor.xml
index 66a2199c30e..f8bee37e5f8 100644
--- a/xml/System.Activities.Presentation.PropertyEditing/DialogPropertyValueEditor.xml
+++ b/xml/System.Activities.Presentation.PropertyEditing/DialogPropertyValueEditor.xml
@@ -131,7 +131,7 @@
method is called instead.
+ If this property returns `null`, the method is called instead.
]]>
diff --git a/xml/System.Activities.Presentation.PropertyEditing/ExtendedPropertyValueEditor.xml b/xml/System.Activities.Presentation.PropertyEditing/ExtendedPropertyValueEditor.xml
index 87c577a18f2..92571e6501d 100644
--- a/xml/System.Activities.Presentation.PropertyEditing/ExtendedPropertyValueEditor.xml
+++ b/xml/System.Activities.Presentation.PropertyEditing/ExtendedPropertyValueEditor.xml
@@ -91,7 +91,7 @@
is set to a .
+ When used, its is set to a .
]]>
@@ -129,7 +129,7 @@
is set to a .
+ Its is set to a .
]]>
diff --git a/xml/System.Activities.Presentation.PropertyEditing/PropertyValue.xml b/xml/System.Activities.Presentation.PropertyEditing/PropertyValue.xml
index 0b96b96df30..8c8f6d7430d 100644
--- a/xml/System.Activities.Presentation.PropertyEditing/PropertyValue.xml
+++ b/xml/System.Activities.Presentation.PropertyEditing/PropertyValue.xml
@@ -85,11 +85,11 @@
if exceptions are caught; if exceptions are propagated to the caller.
- event.
-
+ event.
+
]]>
@@ -228,11 +228,11 @@
if the type supports sub-properties; otherwise, .
- to verify whether sub-properties exist.
-
+ to verify whether sub-properties exist.
+
]]>
@@ -301,11 +301,11 @@
if multiple objects contain this property; otherwise, .
- will return null and will return .
-
+ will return null and will return .
+
]]>
diff --git a/xml/System.Activities.Presentation.Toolbox/ToolboxCategory.xml b/xml/System.Activities.Presentation.Toolbox/ToolboxCategory.xml
index 275c6177dad..7bfc0f74b90 100644
--- a/xml/System.Activities.Presentation.Toolbox/ToolboxCategory.xml
+++ b/xml/System.Activities.Presentation.Toolbox/ToolboxCategory.xml
@@ -32,9 +32,9 @@
collection contains items of type that are added and removed from an instance of the collection using the and methods.
+ The collection contains items of type that are added and removed from an instance of the collection using the and methods.
- The class implements the interface. This allows the collection that is storing the toolbox items to provide notifications when properties like the property are changed and methods like and are used to change the contents of the collection.
+ The class implements the interface. This allows the collection that is storing the toolbox items to provide notifications when properties like the property are changed and methods like and are used to change the contents of the collection.
]]>
@@ -95,7 +95,7 @@
collection can be an empty `string`. This is the value assigned by the parameterless constructor, .
+ The name assigned to the collection can be an empty `string`. This is the value assigned by the parameterless constructor, .
]]>
@@ -396,7 +396,7 @@
## Remarks
Enumerators can be used to read the data in a collection, but they cannot be used to modify the underlying collection.
- Initially, the enumerator is positioned before the first element in the collection. At this position, is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is no longer valid and its behavior is undefined.
+ Initially, the enumerator is positioned before the first element in the collection. At this position, is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is no longer valid and its behavior is undefined.
The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure.
diff --git a/xml/System.Activities.Presentation.Toolbox/ToolboxCategoryItems.xml b/xml/System.Activities.Presentation.Toolbox/ToolboxCategoryItems.xml
index a31125f7fc3..78c46e39a03 100644
--- a/xml/System.Activities.Presentation.Toolbox/ToolboxCategoryItems.xml
+++ b/xml/System.Activities.Presentation.Toolbox/ToolboxCategoryItems.xml
@@ -243,7 +243,7 @@
## Remarks
Enumerators can be used to read the data in a collection, but they cannot be used to modify the underlying collection.
- Initially, the enumerator is positioned before the first element in the collection. At this position, is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is no longer valid and its behavior is undefined.
+ Initially, the enumerator is positioned before the first element in the collection. At this position, is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is no longer valid and its behavior is undefined.
The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure.
@@ -509,7 +509,7 @@
## Remarks
Enumerators can be used to read the data in a collection, but they cannot be used to modify the underlying collection.
- Initially, the enumerator is positioned before the first element in the collection. At this position, is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is no longer valid and its behavior is undefined.
+ Initially, the enumerator is positioned before the first element in the collection. At this position, is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is no longer valid and its behavior is undefined.
The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure.
diff --git a/xml/System.Activities.Presentation.Toolbox/ToolboxControl.xml b/xml/System.Activities.Presentation.Toolbox/ToolboxControl.xml
index f6c8095b6cf..a10ebc1d1c9 100644
--- a/xml/System.Activities.Presentation.Toolbox/ToolboxControl.xml
+++ b/xml/System.Activities.Presentation.Toolbox/ToolboxControl.xml
@@ -36,7 +36,7 @@
This class provides support for representing the toolbox controls when re-hosting the Windows Workflow Designer outside of Visual Studio. It implements . The contains a collection of toolbox categories that hold various categories of tools that can be accessed with the property. It also is able to retrieve the with which it is associated using the property.
> [!WARNING]
-> For activities to load properly in the toolbox, the assembly that contains the activities must be loaded first. Use to load the activity type if it is contained in a different assembly; using instead will cause an exception to be thrown.
+> For activities to load properly in the toolbox, the assembly that contains the activities must be loaded first. Use to load the activity type if it is contained in a different assembly; using instead will cause an exception to be thrown.
]]>
@@ -232,7 +232,7 @@
method is invoked by the method. implements , which, in turn, implements .
+ The method is invoked by the method. implements , which, in turn, implements .
]]>
diff --git a/xml/System.Activities.Presentation.Toolbox/ToolboxItemWrapper.xml b/xml/System.Activities.Presentation.Toolbox/ToolboxItemWrapper.xml
index 95ba4035fe8..62772811743 100644
--- a/xml/System.Activities.Presentation.Toolbox/ToolboxItemWrapper.xml
+++ b/xml/System.Activities.Presentation.Toolbox/ToolboxItemWrapper.xml
@@ -56,7 +56,7 @@
, , , and properties with an empty `string`.
+ The parameterless constructor initializes the , , , and properties with an empty `string`.
]]>
@@ -84,7 +84,7 @@
and properties can be extracted from the `toolType` parameter. The and properties are each initialized with an empty `string`.
+ The and properties can be extracted from the `toolType` parameter. The and properties are each initialized with an empty `string`.
]]>
@@ -114,7 +114,7 @@
and properties can be extracted from the `toolType` parameter. The property is initialized with an empty `string`.
+ The and properties can be extracted from the `toolType` parameter. The property is initialized with an empty `string`.
]]>
@@ -146,7 +146,7 @@
and properties can be extracted from the `toolType` parameter.
+ The and properties can be extracted from the `toolType` parameter.
]]>
diff --git a/xml/System.Activities.Presentation.View/DesignerView.xml b/xml/System.Activities.Presentation.View/DesignerView.xml
index 47d88d733e8..185a31a6c84 100644
--- a/xml/System.Activities.Presentation.View/DesignerView.xml
+++ b/xml/System.Activities.Presentation.View/DesignerView.xml
@@ -1326,7 +1326,7 @@
method to set this property to a representation of a .
+ Call the method to set this property to a representation of a .
]]>
diff --git a/xml/System.Activities.Presentation.View/ExpressionTextBox.xml b/xml/System.Activities.Presentation.View/ExpressionTextBox.xml
index 596197f7853..8630405beab 100644
--- a/xml/System.Activities.Presentation.View/ExpressionTextBox.xml
+++ b/xml/System.Activities.Presentation.View/ExpressionTextBox.xml
@@ -35,54 +35,54 @@
Describes a control that enables the user to edit an expression in an activity designer.
- provides features such as IntelliSense when editing an expression. Such features are provided by a component called the hostable editor. The expression editing interface is extensible and the editor used for editing expressions can be replaced.
-
+ provides features such as IntelliSense when editing an expression. Such features are provided by a component called the hostable editor. The expression editing interface is extensible and the editor used for editing expressions can be replaced.
+
> [!NOTE]
-> This component is not available for use in applications that are being re-hosted outside Visual Studio.
-
- **ExpressionTextBlock** works in the following manner when you edit an expression.
-
-1. When you click on an **ExpressionTextBox**, an object is created and a hostable editor session is instantiated in Visual Studio.
-
-2. When you type inside a hostable editor, note that the features have two sorts of availability.
-
- 1. IntelliSense, completion and colorization support is available immediately.
-
- 2. Validation is called in the background and is available only after a short interval of time elapses. Then, if your expression is invalid, the hosted compiler reports the error and the red error icon displays to the right of your expression.
-
-3. Press the **Enter** key when the **ExpressionTextBox** has the focus to insert new lines in the object. This causes a line commit to occur inside the hostable editor, which triggers a pretty listing and the display of squiggles.
-
-4. The editor instance is destroyed when the **ExpressionTextBox** loses the focus, and the display reverts to a **TextBlock**. If you are on the designer surface or in the property grid, the change to the model item is committed and all controls displaying that same expression are synchronized. However, if you are in a dialog box, the change to the model item is not committed until you click OK. When the model item is committed, is invoked and the entire workflow is validated.
-
-5. When you click on the **ExpressionTextBox** again, a new editor instance is created. In the hostable editor, pretty listing, colorization, and squiggling occurs before you begin editing.
-
- To bind the expression text box to **OwnerActivity**, use to set the data context correctly. The following code sample demonstrates setting the data context correctly for binding to **OwnerActivity**.
-
-```
-
-
-
-
-
-
-
-```
-
- For more information, see and . Also see the [Using the ExpressionTextBox in a Custom Activity Designer](/dotnet/framework/windows-workflow-foundation/samples/using-the-expressiontextbox-in-a-custom-activity-designer) sample topic.
-
-
-
+> This component is not available for use in applications that are being re-hosted outside Visual Studio.
+
+ **ExpressionTextBlock** works in the following manner when you edit an expression.
+
+1. When you click on an **ExpressionTextBox**, an object is created and a hostable editor session is instantiated in Visual Studio.
+
+2. When you type inside a hostable editor, note that the features have two sorts of availability.
+
+ 1. IntelliSense, completion and colorization support is available immediately.
+
+ 2. Validation is called in the background and is available only after a short interval of time elapses. Then, if your expression is invalid, the hosted compiler reports the error and the red error icon displays to the right of your expression.
+
+3. Press the **Enter** key when the **ExpressionTextBox** has the focus to insert new lines in the object. This causes a line commit to occur inside the hostable editor, which triggers a pretty listing and the display of squiggles.
+
+4. The editor instance is destroyed when the **ExpressionTextBox** loses the focus, and the display reverts to a **TextBlock**. If you are on the designer surface or in the property grid, the change to the model item is committed and all controls displaying that same expression are synchronized. However, if you are in a dialog box, the change to the model item is not committed until you click OK. When the model item is committed, is invoked and the entire workflow is validated.
+
+5. When you click on the **ExpressionTextBox** again, a new editor instance is created. In the hostable editor, pretty listing, colorization, and squiggling occurs before you begin editing.
+
+ To bind the expression text box to **OwnerActivity**, use to set the data context correctly. The following code sample demonstrates setting the data context correctly for binding to **OwnerActivity**.
+
+```
+
+
+
+
+
+
+
+```
+
+ For more information, see and . Also see the [Using the ExpressionTextBox in a Custom Activity Designer](/dotnet/framework/windows-workflow-foundation/samples/using-the-expressiontextbox-in-a-custom-activity-designer) sample topic.
+
+
+
## Examples
The is usually used declaratively when creating custom activity designers.
-
+
]]>
@@ -308,11 +308,11 @@ The is usually used
Occurs when the expression editor loses logical focus.
-
@@ -398,11 +398,11 @@ The is usually used
Gets or sets the expression.
The expression.
- is always required. When using the declaratively to bind to arguments, you must always use the to bind the expression to the argument, setting the `ConverterParameter` to `In` or `Out` depending on the direction of the argument.
-
+ is always required. When using the declaratively to bind to arguments, you must always use the to bind the expression to the argument, setting the `ConverterParameter` to `In` or `Out` depending on the direction of the argument.
+
]]>
@@ -534,11 +534,11 @@ The is usually used
Gets or sets the expression type.
The expression type.
- , you can't use the to bind to delegate types and you do not get validation from the hosted compiler. This compiler validation checks to see if the type of the entered expression matches the expected type, and displays a red box around the **ExpressionTextBox** when invalid data is entered into it on an activity designer.
-
+ , you can't use the to bind to delegate types and you do not get validation from the hosted compiler. This compiler validation checks to see if the type of the entered expression matches the expected type, and displays a red box around the **ExpressionTextBox** when invalid data is entered into it on an activity designer.
+
]]>
@@ -717,11 +717,11 @@ The is usually used
Initializes this form.
-
@@ -1077,9 +1077,9 @@ The is usually used
Gets or sets the owner activity.
The owner activity.
-
@@ -1254,11 +1254,11 @@ The is usually used
The target.
Attaches events and names to compiled content.
-
@@ -1322,11 +1322,11 @@ The is usually used
if this instance uses the location expression; otherwise, .
- to an `Out` argument, you would set this property to `True`.
-
+ to an `Out` argument, you would set this property to `True`.
+
]]>
diff --git a/xml/System.Activities.Presentation.View/IExpressionEditorInstance.xml b/xml/System.Activities.Presentation.View/IExpressionEditorInstance.xml
index 29661609847..7b83c6be057 100644
--- a/xml/System.Activities.Presentation.View/IExpressionEditorInstance.xml
+++ b/xml/System.Activities.Presentation.View/IExpressionEditorInstance.xml
@@ -13,11 +13,11 @@
Represents an expression editor instance.
- .
-
+ .
+
]]>
@@ -575,11 +575,11 @@
if the editor instance has aggregate focus; otherwise, .
- or any other control created by the has focus.
-
+ or any other control created by the has focus.
+
]]>
@@ -667,11 +667,11 @@
Represents an event that is raised when the expression editor instance loses aggregate focus.
- and every control created by the loose focus.
-
+ and every control created by the loose focus.
+
]]>
diff --git a/xml/System.Activities.Presentation.View/Selection.xml b/xml/System.Activities.Presentation.View/Selection.xml
index c909c8f6bdc..93836e84838 100644
--- a/xml/System.Activities.Presentation.View/Selection.xml
+++ b/xml/System.Activities.Presentation.View/Selection.xml
@@ -16,11 +16,11 @@
Defines a selection of objects that are published as a in the .
- .
-
+ .
+
]]>
@@ -77,11 +77,11 @@
A parameter array of objects that should be selected.
Creates a object with the specified objects selected.
-
@@ -105,11 +105,11 @@
An enumeration of objects that should be selected.
Creates a object with the specified objects selected.
-
If is .
@@ -134,11 +134,11 @@
An enumeration of objects that should be selected.
Creates a object with the specified objects selected.
-
If is .
@@ -165,11 +165,11 @@
The criteria for including objects. Only those objects in that match the predicate will be added to the selection.
Creates a object with the specified objects selected.
-
If or is .
@@ -196,11 +196,11 @@
The criteria for including objects. Only those objects in that match the predicate will be added to the selection.
Creates a object with the specified objects selected.
-
If or is .
@@ -225,11 +225,11 @@
Returns the item type for this editing context item.
Returns typeof().
- . When you create a derived class, override this property to return the of the derived type.
-
+ . When you create a derived class, override this property to return the of the derived type.
+
]]>
diff --git a/xml/System.Activities.Presentation.View/ViewStateService.xml b/xml/System.Activities.Presentation.View/ViewStateService.xml
index a0db4e13f23..85c2b6f3bf7 100644
--- a/xml/System.Activities.Presentation.View/ViewStateService.xml
+++ b/xml/System.Activities.Presentation.View/ViewStateService.xml
@@ -19,7 +19,7 @@
is an abstract class. Derived classes must store view states when is called, and retrieve them when is called.
+ This is useful so that the state can keep being retrieved when control of the application goes and comes with postbacks. is an abstract class. Derived classes must store view states when is called, and retrieve them when is called.
]]>
@@ -102,7 +102,7 @@
to initially store view state information so that it can be retrieved.
+ Call to initially store view state information so that it can be retrieved.
]]>
@@ -136,7 +136,7 @@
to initially store view state information so that it can be retrieved.
+ Call to initially store view state information so that it can be retrieved.
]]>
@@ -171,7 +171,7 @@
and passing the same values for `modelItem` and `key`.
+ You can retrieve the stored object by calling and passing the same values for `modelItem` and `key`.
]]>
@@ -206,7 +206,7 @@
and passing the same values for `modelItem` and `key`.
+ You can retrieve the stored object by calling and passing the same values for `modelItem` and `key`.
]]>
diff --git a/xml/System.Activities.Presentation.View/VirtualizedContainerService.xml b/xml/System.Activities.Presentation.View/VirtualizedContainerService.xml
index f7bf68567bc..2ba5afe254d 100644
--- a/xml/System.Activities.Presentation.View/VirtualizedContainerService.xml
+++ b/xml/System.Activities.Presentation.View/VirtualizedContainerService.xml
@@ -16,12 +16,12 @@
Represents a virtual container service associated with an editing context and design view. The virtual container service is used to customize the UI virtualization behavior.
-
@@ -97,11 +97,11 @@
Attempts to get a value for the Hint Size Name property.
The destination for the value.
- does not throw an exception if the property is not found in the store.
-
+ does not throw an exception if the property is not found in the store.
+
]]>
@@ -151,11 +151,11 @@
Provides a XAML type system identifier.
- type plus "HintSize".
-
+ type plus "HintSize".
+
]]>
@@ -184,11 +184,11 @@
The value set.
Attempts to set a value for the Hint Size Name property.
- object; therefore the string must be formatted using en-us culture.
-
+ object; therefore the string must be formatted using en-us culture.
+
]]>
diff --git a/xml/System.Activities.Presentation/ActivityDesigner.xml b/xml/System.Activities.Presentation/ActivityDesigner.xml
index b55cd542db7..9ec016aa068 100644
--- a/xml/System.Activities.Presentation/ActivityDesigner.xml
+++ b/xml/System.Activities.Presentation/ActivityDesigner.xml
@@ -19,7 +19,7 @@
and properties of the activity).
+ This type provides the basic look-and-feel functionality for other activity designers and allows a developer to add additional capabilities to an activity designer surface. This is typically done in order to either display additional interesting information to the user of the activity, create a better on canvas editing experience (for example, using the `ExpressionTextBox` on an `If` activity designer), or to allow contained elements to be edited (again, consider the and properties of the activity).
The inherits from and primarily adds the default styling, as well as the ability to customize the icon via the property. It should be used whenever you are creating a designer for a type that derives from . When associated with an type, the property will point to the ModelItem hierarchy describing the instance of that type being edited.
diff --git a/xml/System.Activities.Presentation/ArgumentAccessor.xml b/xml/System.Activities.Presentation/ArgumentAccessor.xml
index 8c7df9eabe3..a2353e8d453 100644
--- a/xml/System.Activities.Presentation/ArgumentAccessor.xml
+++ b/xml/System.Activities.Presentation/ArgumentAccessor.xml
@@ -75,11 +75,11 @@
Gets or sets the method to set an argument into an activity instance.
The method to set an argument into an activity instance.
- will set the value in the editing context, which will not update the underlying value until the editing context completes.
-
+ will set the value in the editing context, which will not update the underlying value until the editing context completes.
+
]]>
diff --git a/xml/System.Activities.Presentation/CachedResourceDictionaryExtension.xml b/xml/System.Activities.Presentation/CachedResourceDictionaryExtension.xml
index 6f4c7c1fed3..7a31cf4ae3a 100644
--- a/xml/System.Activities.Presentation/CachedResourceDictionaryExtension.xml
+++ b/xml/System.Activities.Presentation/CachedResourceDictionaryExtension.xml
@@ -22,11 +22,11 @@
Provides a cached dictionary that associates resource dictionaries with their URIs.
- class that provides XAML markup extensions. Markup extensions return objects based on string attribute values or markup elements in XAML. The method of each extension can use an object at run time that can provide context.
-
+ class that provides XAML markup extensions. Markup extensions return objects based on string attribute values or markup elements in XAML. The method of each extension can use an object at run time that can provide context.
+
]]>
@@ -77,11 +77,11 @@
Returns an object that is set as the value of the target property for this markup extension.
The value to set on the property where the extension is applied.
- method of each extension can use an object at run time that can provide context.
-
+ method of each extension can use an object at run time that can provide context.
+
]]>
diff --git a/xml/System.Activities.Presentation/ContextItemManager.xml b/xml/System.Activities.Presentation/ContextItemManager.xml
index 6d3fd0e87e1..f3747a4ed9e 100644
--- a/xml/System.Activities.Presentation/ContextItemManager.xml
+++ b/xml/System.Activities.Presentation/ContextItemManager.xml
@@ -115,7 +115,7 @@
method, which must be implemented for this method to provide the type checking functionality.
+ This generic method invokes the abstract method, which must be implemented for this method to provide the type checking functionality.
]]>
@@ -231,7 +231,7 @@
method, which must be implemented for this method to provide the get type functionality.
+ This generic method invokes the abstract method, which must be implemented for this method to provide the get type functionality.
]]>
@@ -295,7 +295,7 @@
method.
+ Use this method in your implementations of the method.
]]>
diff --git a/xml/System.Activities.Presentation/EditingContext.xml b/xml/System.Activities.Presentation/EditingContext.xml
index 5476f395cca..81304a6ac72 100644
--- a/xml/System.Activities.Presentation/EditingContext.xml
+++ b/xml/System.Activities.Presentation/EditingContext.xml
@@ -20,11 +20,11 @@
Contains contextual state information for a designer, such as the . This includes permanent state information, such as the list of services running in the designer. It also includes transient state consisting of context items including the set of currently selected objects as well as the editing tool being used to manipulate objects on the design surface.
- represents the communication boundary that is shared between the hosting application and the Windows Workflow Designer. The was implemented as a concrete class for ease of use. Override and to use customized managers derived from and .
-
+ represents the communication boundary that is shared between the hosting application and the Windows Workflow Designer. The was implemented as a concrete class for ease of use. Override and to use customized managers derived from and .
+
]]>
@@ -72,11 +72,11 @@
Creates an instance of the context item manager that is returned by the property.
An instance of the context item manager that is returned by the property.
- that supports delayed activation of design editor managers through the declaration of a attribute on the design editor manager.
-
+ that supports delayed activation of design editor managers through the declaration of a attribute on the design editor manager.
+
]]>
@@ -101,11 +101,11 @@
Creates an instance of the service manager to be returned from the property.
A object.
- that supports delayed activation of design editor managers through the declaration of a attribute on the design editor manager.
-
+ that supports delayed activation of design editor managers through the declaration of a attribute on the design editor manager.
+
]]>
@@ -208,11 +208,11 @@
Returns the local collection of context items stored by the current editing context.
The collection of objects used in this editing context.
- collection is for data that is shared between a host and the designer. This data provides the mechanism needed to hook into subscription and change notification.
-
+ collection is for data that is shared between a host and the designer. This data provides the mechanism needed to hook into subscription and change notification.
+
]]>
@@ -236,11 +236,11 @@
Returns the service manager used in the current editing context.
The used in this editing context.
- represent functionality that is either provided by the host for the designer to use or that is used by the designer to make functionality available to all designers within the editor.
-
+ represent functionality that is either provided by the host for the designer to use or that is used by the designer to make functionality available to all designers within the editor.
+
]]>
diff --git a/xml/System.Activities.Presentation/IModalService.xml b/xml/System.Activities.Presentation/IModalService.xml
index 2023c4f38de..2dc55ffad1a 100644
--- a/xml/System.Activities.Presentation/IModalService.xml
+++ b/xml/System.Activities.Presentation/IModalService.xml
@@ -13,17 +13,17 @@
Enables notification to a host application that a modal dialog is displayed.
- interface provides an interface to communicate the current modal status.
-
- The Windows Workflow Designer calls the method. When the `isModal` parameter is set to `true`, the host is notified that a modal dialog is displayed.
-
- This is an optional service. If a host application does not care about the modal status, you need not use the service.
-
- In the current implementation, if a Windows Presentation Foundation (WPF) message box (which is a modal dialog) is invoked, the is not called. If the host application requires this information, another workaround must be created.
-
+ interface provides an interface to communicate the current modal status.
+
+ The Windows Workflow Designer calls the method. When the `isModal` parameter is set to `true`, the host is notified that a modal dialog is displayed.
+
+ This is an optional service. If a host application does not care about the modal status, you need not use the service.
+
+ In the current implementation, if a Windows Presentation Foundation (WPF) message box (which is a modal dialog) is invoked, the is not called. If the host application requires this information, another workaround must be created.
+
]]>
diff --git a/xml/System.Activities.Presentation/ServiceManager.xml b/xml/System.Activities.Presentation/ServiceManager.xml
index 05908bafc2a..802cf6f6bb8 100644
--- a/xml/System.Activities.Presentation/ServiceManager.xml
+++ b/xml/System.Activities.Presentation/ServiceManager.xml
@@ -29,7 +29,7 @@
represent functionality that is either provided by the host for the designer to use or that is used by the designer to make functionality available to all designers within the editor. It is obtained from the by the property.
+ represent functionality that is either provided by the host for the designer to use or that is used by the designer to make functionality available to all designers within the editor. It is obtained from the by the property.
]]>
@@ -163,7 +163,7 @@
, this method throws a if the service is not available.
+ Unlike , this method throws a if the service is not available.
]]>
diff --git a/xml/System.Activities.Presentation/WorkflowDesigner.xml b/xml/System.Activities.Presentation/WorkflowDesigner.xml
index c6cc7fff951..97eac5a5dae 100644
--- a/xml/System.Activities.Presentation/WorkflowDesigner.xml
+++ b/xml/System.Activities.Presentation/WorkflowDesigner.xml
@@ -67,7 +67,7 @@
- Use , which executes whenever the model is assigned to, or when the value the property points to is updated.
-- Subscribe to the dependency property's availability using .
+- Subscribe to the dependency property's availability using .
]]>
@@ -396,7 +396,7 @@
to convert the current workflow to text. After setting this value, call to load the XAML into the workflow.
+ Before getting this value, call to convert the current workflow to text. After setting this value, call to load the XAML into the workflow.
]]>
diff --git a/xml/System.Activities.Presentation/WorkflowItemsPresenter.xml b/xml/System.Activities.Presentation/WorkflowItemsPresenter.xml
index 2f3411fec79..ead88c42324 100644
--- a/xml/System.Activities.Presentation/WorkflowItemsPresenter.xml
+++ b/xml/System.Activities.Presentation/WorkflowItemsPresenter.xml
@@ -448,7 +448,7 @@
is based on a vertically oriented `StackPanel`. As an illustration, the `ItemsPanel` for the designer of activities is based on a horizontally oriented `StackPanel`.
+ By providing a custom panel template, you can customize and control the layout of the contained items. The default is based on a vertically oriented `StackPanel`. As an illustration, the `ItemsPanel` for the designer of activities is based on a horizontally oriented `StackPanel`.
@@ -635,7 +635,7 @@
, it is removed.
+ If `modelItem` is in , it is removed.
]]>
diff --git a/xml/System.Activities.Statements/Catch`1.xml b/xml/System.Activities.Statements/Catch`1.xml
index 1a470c6545a..3dec4e310b0 100644
--- a/xml/System.Activities.Statements/Catch`1.xml
+++ b/xml/System.Activities.Statements/Catch`1.xml
@@ -30,18 +30,18 @@
The type of exception that the block is handling.
Contains the actions to be executed after an exception is raised in the corresponding Try block of a activity.
- activities cannot be reordered in the designer. To reorder the collection of activities, either delete and re-add them in the correct order, or use the xaml (code) view for the workflow.
-
-
-
-## Examples
- The following code sample demonstrates creating a activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet1":::
-
+ activities cannot be reordered in the designer. To reorder the collection of activities, either delete and re-add them in the correct order, or use the xaml (code) view for the workflow.
+
+
+
+## Examples
+ The following code sample demonstrates creating a activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet1":::
+
]]>
@@ -67,13 +67,13 @@
Creates a new instance of the class.
- activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet1":::
-
+ activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet1":::
+
]]>
@@ -111,18 +111,18 @@
The handler for the exception being caught.
The activity action.
- object.
-
-
-
-## Examples
- The following code sample demonstrates assigning the Action property of a activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet1":::
-
+ object.
+
+
+
+## Examples
+ The following code sample demonstrates assigning the Action property of a activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet1":::
+
]]>
diff --git a/xml/System.Activities.Statements/CompensableActivity.xml b/xml/System.Activities.Statements/CompensableActivity.xml
index 972ec998bf7..6312c87920d 100644
--- a/xml/System.Activities.Statements/CompensableActivity.xml
+++ b/xml/System.Activities.Statements/CompensableActivity.xml
@@ -25,11 +25,11 @@
An activity that supports compensation of its child activities.
- allows a developer to specify a activity that defines a long-running task that performs their core business logic. It also allows the developer to optionally specify a compensation and confirmation activity to schedule appropriate business logic in the event of errors or successful completion of the . Compensation and confirmation of a is invoked by using the returned by the . is an opaque, typed object returned after successful completion of a activity's . This is used by the and activities to explicitly invoke confirmation and compensation of a . can be composed in a nested hierarchical fashion in the workflow. For more information, see [Compensation Programming Model](/previous-versions/dd489415(v=vs.100)).
-
+ allows a developer to specify a activity that defines a long-running task that performs their core business logic. It also allows the developer to optionally specify a compensation and confirmation activity to schedule appropriate business logic in the event of errors or successful completion of the . Compensation and confirmation of a is invoked by using the returned by the . is an opaque, typed object returned after successful completion of a activity's . This is used by the and activities to explicitly invoke confirmation and compensation of a . can be composed in a nested hierarchical fashion in the workflow. For more information, see [Compensation Programming Model](/previous-versions/dd489415(v=vs.100)).
+
]]>
@@ -88,11 +88,11 @@
Gets or sets the activity that is scheduled when the executes.
The activity that is scheduled when the executes.
- is thrown.
-
+ is thrown.
+
]]>
@@ -182,13 +182,13 @@
Gets or sets the activity that is scheduled when the activity is canceled.
The activity that is scheduled when the activity is canceled.
- can be used to specify custom cancellation logic for the of the .
-
- This property is read-only at runtime. If the value is set at runtime, an is thrown.
-
+ can be used to specify custom cancellation logic for the of the .
+
+ This property is read-only at runtime. If the value is set at runtime, an is thrown.
+
]]>
@@ -251,13 +251,13 @@
Gets or sets the activity that is scheduled when compensation is performed on the .
The activity that is scheduled when compensation is performed on the .
- can be used to specify custom compensation logic for the of the .
-
- This property is read-only at runtime. If the value is set at runtime, an is thrown.
-
+ can be used to specify custom compensation logic for the of the .
+
+ This property is read-only at runtime. If the value is set at runtime, an is thrown.
+
]]>
@@ -299,13 +299,13 @@
Gets or sets the activity that is scheduled when confirmation is performed for this .
The activity that is scheduled when confirmation is performed for this .
- can be used to specify custom confirmation logic for the of the .
-
- This property is read-only at runtime. If the value is set at runtime, an is thrown.
-
+ can be used to specify custom confirmation logic for the of the .
+
+ This property is read-only at runtime. If the value is set at runtime, an is thrown.
+
]]>
diff --git a/xml/System.Activities.Statements/Compensate.xml b/xml/System.Activities.Statements/Compensate.xml
index b4024a717c5..3b6a4c5395e 100644
--- a/xml/System.Activities.Statements/Compensate.xml
+++ b/xml/System.Activities.Statements/Compensate.xml
@@ -140,13 +140,13 @@
Gets or sets the that contains the for this activity.
A that contains the for this .
- of the is specified, the activity explicitly invokes the compensation handler of , which returns the . When the of the is not specified, the activity invokes the default compensation for any child activities in the reverse order of successful completion. An is thrown if the refers to a that was previously confirmed or compensated.
-
- This property is read-only at runtime. If the value is set at runtime, an is raised.
-
+ of the is specified, the activity explicitly invokes the compensation handler of , which returns the . When the of the is not specified, the activity invokes the default compensation for any child activities in the reverse order of successful completion. An is thrown if the refers to a that was previously confirmed or compensated.
+
+ This property is read-only at runtime. If the value is set at runtime, an is raised.
+
]]>
diff --git a/xml/System.Activities.Statements/Confirm.xml b/xml/System.Activities.Statements/Confirm.xml
index b00de42f12d..457a62857fb 100644
--- a/xml/System.Activities.Statements/Confirm.xml
+++ b/xml/System.Activities.Statements/Confirm.xml
@@ -136,13 +136,13 @@
Gets or sets the that contains the for this activity.
The that contains the for this activity.
- of the is specified, the activity explicitly invokes the confirmation handler of the , which returns the . When the of the is not specified, the activity executes the default confirmation for any child activities in the reverse order of successful completion. An is thrown if the refers to a that was previously confirmed or compensated.
-
- This property is read-only at runtime. If the value is set at runtime, an is raised.
-
+ of the is specified, the activity explicitly invokes the confirmation handler of the , which returns the . When the of the is not specified, the activity executes the default confirmation for any child activities in the reverse order of successful completion. An is thrown if the refers to a that was previously confirmed or compensated.
+
+ This property is read-only at runtime. If the value is set at runtime, an is raised.
+
]]>
diff --git a/xml/System.Activities.Statements/FlowSwitch`1.xml b/xml/System.Activities.Statements/FlowSwitch`1.xml
index b249cd1c95c..263fc9f06f6 100644
--- a/xml/System.Activities.Statements/FlowSwitch`1.xml
+++ b/xml/System.Activities.Statements/FlowSwitch`1.xml
@@ -26,13 +26,13 @@
The type of the expression to evaluate against cases.
A specialized that allows modeling a switch construct, with one expression and one outcome for each match.
- node. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet5":::
-
+ node. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet5":::
+
]]>
@@ -52,13 +52,13 @@
Creates a new instance of the class.
- node. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet5":::
-
+ node. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet5":::
+
]]>
@@ -88,18 +88,18 @@
Gets a dictionary of cases to be processed by the element.
The collection of cases.
- and a corresponding to execute.
-
-
-
-## Examples
- The following code sample demonstrates setting the Cases property of a node. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet5":::
-
+ and a corresponding to execute.
+
+
+
+## Examples
+ The following code sample demonstrates setting the Cases property of a node. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet5":::
+
]]>
@@ -137,13 +137,13 @@
The to be executed if no elements in the collection match the result of the evaluation of the .
The default to execute.
- node. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet5":::
-
+ node. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet5":::
+
]]>
@@ -208,13 +208,13 @@
The expression to evaluate against the collection of .
The expression to evaluate.
- node. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet5":::
-
+ node. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet5":::
+
]]>
diff --git a/xml/System.Activities.Statements/Flowchart.xml b/xml/System.Activities.Statements/Flowchart.xml
index f46e96ce6d1..0ccfd6f128a 100644
--- a/xml/System.Activities.Statements/Flowchart.xml
+++ b/xml/System.Activities.Statements/Flowchart.xml
@@ -22,18 +22,18 @@
Represents the models workflows using the familiar flowchart paradigm.
- activity allows free-form creation of a workflow using nodes and links.
-
-
-
-## Examples
- The following code sample demonstrates creating a activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet2":::
-
+ activity allows free-form creation of a workflow using nodes and links.
+
+
+
+## Examples
+ The following code sample demonstrates creating a activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet2":::
+
]]>
@@ -53,13 +53,13 @@
Creates a new instance of the class.
- activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet2":::
-
+ activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet2":::
+
]]>
@@ -137,13 +137,13 @@
Gets or sets the collection of objects contained by the flowchart.
A collection of objects.
- activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet2":::
-
+ activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet2":::
+
]]>
@@ -207,18 +207,18 @@
Gets or sets the to be executed when the flowchart starts.
The starting node.
- .
-
-
-
-## Examples
- The following code sample demonstrates configuring the StartNode of a activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet2":::
-
+ .
+
+
+
+## Examples
+ The following code sample demonstrates configuring the StartNode of a activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet2":::
+
]]>
@@ -294,13 +294,13 @@
Gets or sets the collection of objects associated with the , which are available to share state across the child activities contained within the Flowchart.
The collection of variables.
- activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet2":::
-
+ activity. This example is from the [Fault Handling in a Flowchart Activity Using TryCatch](/dotnet/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_flowchartwithfaulthandling/cs/program.cs" id="Snippet2":::
+
]]>
diff --git a/xml/System.Activities.Statements/ForEach`1.xml b/xml/System.Activities.Statements/ForEach`1.xml
index 3ca6d9323c6..286d1719898 100644
--- a/xml/System.Activities.Statements/ForEach`1.xml
+++ b/xml/System.Activities.Statements/ForEach`1.xml
@@ -26,17 +26,17 @@
The type of the values provided in the collection.
Executes an activity action once for each value provided in the collection.
- is similar to the keyword `foreach` but is implemented as an activity rather than a language statement. Note that unlike `foreach` in C#, the activity uses , rather than .
-
+ is similar to the keyword `foreach` but is implemented as an activity rather than a language statement. Note that unlike `foreach` in C#, the activity uses , rather than .
+
## Examples
-The following code sample demonstrates creating a activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_dynamicactivitycreation/cs/program.cs" id="Snippet1":::
-
+The following code sample demonstrates creating a activity.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_dynamicactivitycreation/cs/program.cs" id="Snippet1":::
+
]]>
@@ -56,14 +56,14 @@ The following code sample demonstrates creating a
Creates a new instance of the class.
- activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_dynamicactivitycreation/cs/program.cs" id="Snippet1":::
-
+The following code sample demonstrates creating a activity.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_dynamicactivitycreation/cs/program.cs" id="Snippet1":::
+
]]>
@@ -101,14 +101,14 @@ The following code sample demonstrates creating a The to be executed for each item in the collection.
The action to be executed.
- activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_dynamicactivitycreation/cs/program.cs" id="Snippet1":::
-
+The following code sample demonstrates setting the Body property of a activity.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_dynamicactivitycreation/cs/program.cs" id="Snippet1":::
+
]]>
@@ -224,14 +224,14 @@ The following code sample demonstrates setting the Body property of a The activity's collection of inputs for the execution of the activity action.
The collection of values.
- activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_dynamicactivitycreation/cs/program.cs" id="Snippet1":::
-
+The following code sample demonstrates setting the Values property of a activity.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_dynamicactivitycreation/cs/program.cs" id="Snippet1":::
+
]]>
diff --git a/xml/System.Activities.Statements/Parallel.xml b/xml/System.Activities.Statements/Parallel.xml
index 4e517cf163d..5010d898b96 100644
--- a/xml/System.Activities.Statements/Parallel.xml
+++ b/xml/System.Activities.Statements/Parallel.xml
@@ -25,7 +25,7 @@
activity operates by simultaneously scheduling each in its collection at the start. It completes when all of its complete or when its property evaluates to `true`. While all the objects run asynchronously, they do not execute on separate threads, so each successive activity only executes when the previously scheduled activity completes or goes idle. If none of the child activities of this activity go idle, this activity execute in the same way that a activity does.
+ A activity operates by simultaneously scheduling each in its collection at the start. It completes when all of its complete or when its property evaluates to `true`. While all the objects run asynchronously, they do not execute on separate threads, so each successive activity only executes when the previously scheduled activity completes or goes idle. If none of the child activities of this activity go idle, this activity execute in the same way that a activity does.
@@ -197,7 +197,7 @@ The following code sample demonstrates setting the Branches property of a collection are canceled. If this property is not set, all objects in the collection execute until completion.
+ If this property evaluates to `true`, then the other scheduled elements in the collection are canceled. If this property is not set, all objects in the collection execute until completion.
## Examples
diff --git a/xml/System.Activities.Statements/ParallelForEach`1.xml b/xml/System.Activities.Statements/ParallelForEach`1.xml
index 1c5337609f0..37597f27f0e 100644
--- a/xml/System.Activities.Statements/ParallelForEach`1.xml
+++ b/xml/System.Activities.Statements/ParallelForEach`1.xml
@@ -26,18 +26,18 @@
The type of the values provided in the collection.
Enumerates the elements of a collection and executes an embedded statement for each element of the collection in parallel.
- , or activities that derive from ), they do not run on separate threads, so each successive activity will only execute when the previously scheduled activity completes or goes idle. If none of the child activities of this activity are asynchronous or go idle, this activity execute in the same way that a activity does.
-
-
-
-## Examples
- The following code sample demonstrates creating a activity. This example is from the [Corporate Purchase Process](/dotnet/framework/windows-workflow-foundation/samples/corporate-purchase-process) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_purchaseprocess/cs/purchaseprocessworkflow.cs" id="Snippet1":::
-
+ , or activities that derive from ), they do not run on separate threads, so each successive activity will only execute when the previously scheduled activity completes or goes idle. If none of the child activities of this activity are asynchronous or go idle, this activity execute in the same way that a activity does.
+
+
+
+## Examples
+ The following code sample demonstrates creating a activity. This example is from the [Corporate Purchase Process](/dotnet/framework/windows-workflow-foundation/samples/corporate-purchase-process) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_purchaseprocess/cs/purchaseprocessworkflow.cs" id="Snippet1":::
+
]]>
@@ -63,13 +63,13 @@
Creates a new instance of the class.
- activity. This example is from the [Corporate Purchase Process](/dotnet/framework/windows-workflow-foundation/samples/corporate-purchase-process) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_purchaseprocess/cs/purchaseprocessworkflow.cs" id="Snippet1":::
-
+ activity. This example is from the [Corporate Purchase Process](/dotnet/framework/windows-workflow-foundation/samples/corporate-purchase-process) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_purchaseprocess/cs/purchaseprocessworkflow.cs" id="Snippet1":::
+
]]>
@@ -107,13 +107,13 @@
The that is executed once for every value contained in the collection.
The contained activity action.
- activity. This example is from the [Corporate Purchase Process](/dotnet/framework/windows-workflow-foundation/samples/corporate-purchase-process) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_purchaseprocess/cs/purchaseprocessworkflow.cs" id="Snippet1":::
-
+ activity. This example is from the [Corporate Purchase Process](/dotnet/framework/windows-workflow-foundation/samples/corporate-purchase-process) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_purchaseprocess/cs/purchaseprocessworkflow.cs" id="Snippet1":::
+
]]>
@@ -175,11 +175,11 @@
Evaluated after each iteration completes.
The completion expression.
-
@@ -271,13 +271,13 @@
The collection of values used as parameters for each iteration of the activity contained in the .
The collection of values.
- activity. This example is from the [Corporate Purchase Process](/dotnet/framework/windows-workflow-foundation/samples/corporate-purchase-process) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_purchaseprocess/cs/purchaseprocessworkflow.cs" id="Snippet1":::
-
+ activity. This example is from the [Corporate Purchase Process](/dotnet/framework/windows-workflow-foundation/samples/corporate-purchase-process) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_purchaseprocess/cs/purchaseprocessworkflow.cs" id="Snippet1":::
+
]]>
diff --git a/xml/System.Activities.Statements/Pick.xml b/xml/System.Activities.Statements/Pick.xml
index 854295bd3f5..6e0ac0d779e 100644
--- a/xml/System.Activities.Statements/Pick.xml
+++ b/xml/System.Activities.Statements/Pick.xml
@@ -22,16 +22,16 @@
Provides event-based control flow modeling.
- 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 activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
-
+ 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 activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
+
]]>
@@ -51,13 +51,13 @@
Creates a new instance of the class.
- activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
-
+ activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
+
]]>
@@ -81,13 +81,13 @@
The collection of objects that the activity potentially executes one of, based on incoming events.
The branch collection.
- activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
-
+ activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
+
]]>
diff --git a/xml/System.Activities.Statements/PickBranch.xml b/xml/System.Activities.Statements/PickBranch.xml
index ce8c4035730..9d351be39b2 100644
--- a/xml/System.Activities.Statements/PickBranch.xml
+++ b/xml/System.Activities.Statements/PickBranch.xml
@@ -22,18 +22,18 @@
A potential path of execution within a activity.
- contains a and an . At the beginning of a element's execution, all the trigger activities from all elements are scheduled. When the first (leftmost) activity completes, the corresponding action activity is scheduled, and all other trigger activities are canceled.
-
-
-
-## Examples
- The following code sample demonstrates creating a activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
-
+ contains a and an . At the beginning of a element's execution, all the trigger activities from all elements are scheduled. When the first (leftmost) activity completes, the corresponding action activity is scheduled, and all other trigger activities are canceled.
+
+
+
+## Examples
+ The following code sample demonstrates creating a activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
+
]]>
@@ -53,13 +53,13 @@
Creates a new instance of the activity.
- activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
-
+ activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
+
]]>
@@ -101,13 +101,13 @@
The to execute if this branch is triggered for execution.
The activity to execute.
- activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
-
+ activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
+
]]>
@@ -184,13 +184,13 @@
The activity whose completion activates this pick branch.
The triggering activity.
- activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
-
+ activity. This example is from the [Using the Pick Activity](/dotnet/framework/windows-workflow-foundation/samples/using-the-pick-activity) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_pick/cs/program.cs" id="Snippet1":::
+
]]>
diff --git a/xml/System.Activities.Statements/StateMachine.xml b/xml/System.Activities.Statements/StateMachine.xml
index 1946005d3b9..61c4c71ea26 100644
--- a/xml/System.Activities.Statements/StateMachine.xml
+++ b/xml/System.Activities.Statements/StateMachine.xml
@@ -114,11 +114,11 @@
Gets or sets the start state of the .
Returns .
- .
-
+ .
+
]]>
diff --git a/xml/System.Activities.Statements/Switch`1.xml b/xml/System.Activities.Statements/Switch`1.xml
index ceadfbab4fa..1c58e168268 100644
--- a/xml/System.Activities.Statements/Switch`1.xml
+++ b/xml/System.Activities.Statements/Switch`1.xml
@@ -29,11 +29,11 @@
dictionary consists of a value (serving as the key for the dictionary) and an activity (serving as the value for the dictionary). The is evaluated and compared against the keys in the dictionary. If a match is found, the corresponding activity is executed. Every key in the dictionary must be unique according to the dictionary's equality comparer.
+ Each case in the dictionary consists of a value (serving as the key for the dictionary) and an activity (serving as the value for the dictionary). The is evaluated and compared against the keys in the dictionary. If a match is found, the corresponding activity is executed. Every key in the dictionary must be unique according to the dictionary's equality comparer.
## Examples
-The following code sample demonstrates creating a activity.
+The following code sample demonstrates creating a activity.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_procedurals/cs/program.cs" id="Snippet1":::
@@ -53,7 +53,7 @@ The following code sample demonstrates creating a activity.
+The following code sample demonstrates creating a activity.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_procedurals/cs/program.cs" id="Snippet1":::
@@ -86,7 +86,7 @@ The following code sample demonstrates creating a activity.
+The following code sample demonstrates creating a activity.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_procedurals/cs/program.cs" id="Snippet1":::
@@ -207,7 +207,7 @@ The following code sample demonstrates creating a activity.
+The following code sample demonstrates setting the Cases property of a activity.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_procedurals/cs/program.cs" id="Snippet1":::
@@ -318,7 +318,7 @@ The following code sample demonstrates setting the Cases property of a activity.
+The following code sample demonstrates setting the Expression property of a activity.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_procedurals/cs/program.cs" id="Snippet1":::
diff --git a/xml/System.Activities.Statements/TerminateWorkflow.xml b/xml/System.Activities.Statements/TerminateWorkflow.xml
index f308e9081d5..c9250c71ad6 100644
--- a/xml/System.Activities.Statements/TerminateWorkflow.xml
+++ b/xml/System.Activities.Statements/TerminateWorkflow.xml
@@ -101,7 +101,7 @@
is a if only is set. If only is set, that exception is passed to . If both and are set, a is passed with the specified , and is set as the exception's property. If neither is set, a default is created.
+ The exception that is passed to is a if only is set. If only is set, that exception is passed to . If both and are set, a is passed with the specified , and is set as the exception's property. If neither is set, a default is created.
]]>
@@ -167,7 +167,7 @@
is a if only is set. If only is set, that exception is passed to . If both and are set, a is passed with the specified , and is set as the exception's property. If neither is set, a default is created.
+ The exception that is passed to is a if only is set. If only is set, that exception is passed to . If both and are set, a is passed with the specified , and is set as the exception's property. If neither is set, a default is created.
]]>
diff --git a/xml/System.Activities.Statements/TransactionScope.xml b/xml/System.Activities.Statements/TransactionScope.xml
index 18e11f99980..1323edb131f 100644
--- a/xml/System.Activities.Statements/TransactionScope.xml
+++ b/xml/System.Activities.Statements/TransactionScope.xml
@@ -22,20 +22,20 @@
An activity that demarcates a transaction boundary.
- is started if one does not already exist. The transaction commits when the activity and all other participants in the transaction have completed successfully.
-
+ is started if one does not already exist. The transaction commits when the activity and all other participants in the transaction have completed successfully.
+
> [!NOTE]
-> The activity member of a activity that is the child of a will not execute if an unhandled exception propagates past the boundary.
+> The activity member of a activity that is the child of a will not execute if an unhandled exception propagates past the boundary.
## Examples
The following code sample demonstrates creating a activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nestedtransactionscope/cs/program.cs" id="Snippet1":::
-
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nestedtransactionscope/cs/program.cs" id="Snippet1":::
+
]]>
@@ -55,14 +55,14 @@ The following code sample demonstrates creating a
Initializes a new instance of the class.
- activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nestedtransactionscope/cs/program.cs" id="Snippet1":::
-
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nestedtransactionscope/cs/program.cs" id="Snippet1":::
+
]]>
@@ -97,11 +97,11 @@ The following code sample demonstrates creating a
if the workflow should be aborted.
- is thrown.
-
+ is thrown.
+
]]>
@@ -139,11 +139,11 @@ The following code sample demonstrates creating a Gets or sets the activity that is scheduled when the executes.
The activity that is scheduled when the executes.
- is thrown.
-
+ is thrown.
+
]]>
@@ -246,11 +246,11 @@ The following code sample demonstrates creating a Gets or sets the for this .
The for this .
- is thrown.
-
+ is thrown.
+
]]>
@@ -338,17 +338,17 @@ The following code sample demonstrates creating a Gets or sets the that indicates the timeout period for the transaction used for this .
The that indicates the timeout period for the transaction used for this .
- is thrown.
## Examples
The following code sample demonstrates setting the Timeout property of a activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nestedtransactionscope/cs/program.cs" id="Snippet1":::
-
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nestedtransactionscope/cs/program.cs" id="Snippet1":::
+
]]>
diff --git a/xml/System.Activities.Statements/TryCatch.xml b/xml/System.Activities.Statements/TryCatch.xml
index 0455c2490b8..d94e6bbaea2 100644
--- a/xml/System.Activities.Statements/TryCatch.xml
+++ b/xml/System.Activities.Statements/TryCatch.xml
@@ -16,13 +16,13 @@
Contains activities to be executed by the workflow runtime in an exception handling block.
- [!NOTE]
-> The activity member of a activity that is the child of a will not execute if an unhandled exception propagates past the boundary.
-
+> The activity member of a activity that is the child of a will not execute if an unhandled exception propagates past the boundary.
+
]]>
@@ -117,13 +117,13 @@
The collection of elements to be checked when the activity throws an exception.
The catch collection.
- activity is executed. If no exact match is found, the with the closest matching is executed.
-
+ activity is executed. If no exact match is found, the with the closest matching is executed.
+
Once placed in the designer, activities cannot be reordered in the designer. To reorder the collection of activities, either delete and re-add them in the correct order, or use the XAML (code) view for the workflow.
-
+
]]>
diff --git a/xml/System.Activities.Statements/WriteLine.xml b/xml/System.Activities.Statements/WriteLine.xml
index 64e8e434ef8..aee24474435 100644
--- a/xml/System.Activities.Statements/WriteLine.xml
+++ b/xml/System.Activities.Statements/WriteLine.xml
@@ -163,11 +163,11 @@
The to write the to.
The text writer.
- activity writes its to the console.
-
+ activity writes its to the console.
+
]]>
diff --git a/xml/System.Activities.Tracking/ActivityInfo.xml b/xml/System.Activities.Tracking/ActivityInfo.xml
index b620d459ace..84cd76d4b95 100644
--- a/xml/System.Activities.Tracking/ActivityInfo.xml
+++ b/xml/System.Activities.Tracking/ActivityInfo.xml
@@ -103,11 +103,11 @@
Gets the run-time ID of the activity instance.
The instance ID of the activity.
- contains the ID of the activity and does not change while the contains the ID of the specific instance of the activity. The is different for each specific instance. For example, an activity that is processed in a loop would have a different for each cycle through the loop while the would remain the same.
-
+ contains the ID of the activity and does not change while the contains the ID of the specific instance of the activity. The is different for each specific instance. For example, an activity that is processed in a loop would have a different for each cycle through the loop while the would remain the same.
+
]]>
diff --git a/xml/System.Activities.Tracking/ImplementationVisibility.xml b/xml/System.Activities.Tracking/ImplementationVisibility.xml
index 79fb6c27076..69688bce5e7 100644
--- a/xml/System.Activities.Tracking/ImplementationVisibility.xml
+++ b/xml/System.Activities.Tracking/ImplementationVisibility.xml
@@ -15,11 +15,11 @@
Describes the visibility modes within a tracking profile.
- .
-
+ .
+
]]>
diff --git a/xml/System.Activities.Tracking/TrackingParticipant.xml b/xml/System.Activities.Tracking/TrackingParticipant.xml
index c6bfa835b3d..9fde09f0c57 100644
--- a/xml/System.Activities.Tracking/TrackingParticipant.xml
+++ b/xml/System.Activities.Tracking/TrackingParticipant.xml
@@ -16,11 +16,11 @@
The base class for workflow extensions that interact with the workflow tracking infrastructure and access tracking records.
-
@@ -77,11 +77,11 @@
When implemented in a derived class, begins asynchronous processing of the tracking record.
The result of the operation.
- that the workflow runtime uses to wait for completion. The default implementation is to call and return a Completed status.
-
+ that the workflow runtime uses to wait for completion. The default implementation is to call and return a Completed status.
+
]]>
@@ -108,11 +108,11 @@
The status of the operation.
When implemented in a derived class, represents the end of an asynchronous tracking operation.
-
@@ -141,11 +141,11 @@
The time period after which the provider aborts the attempt.
When implemented in a derived class, used to synchronously process the tracking record.
-
@@ -179,11 +179,11 @@
The tracking profile object used by the tracking participant. Before adding the tracking participant to the workflow extensions, the tracking profile is set on the participant.
The tracking profile.
-
diff --git a/xml/System.Activities.Validation/ActivityValidationServices.xml b/xml/System.Activities.Validation/ActivityValidationServices.xml
index dc9bb16d301..193dc24a240 100644
--- a/xml/System.Activities.Validation/ActivityValidationServices.xml
+++ b/xml/System.Activities.Validation/ActivityValidationServices.xml
@@ -53,11 +53,11 @@
Verifies that a workflow activity is correctly configured according to the validation logic. This logic can be the method of the activities to validate, or build and policy constraints.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -85,11 +85,11 @@
Verifies that a workflow activity is correctly configured according to the validation logic. This logic can be the method of the activities to validate, or build and policy constraints.
A collection of validation errors, each of which can contain the name of the validated activity, a descriptive message, an error code, and other information.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -119,11 +119,11 @@
Verifies that a workflow activity is correctly configured according to the validation logic. This logic can be the cacheMetadata method of the activities to validate, or build and policy constraints.
A collection of validation errors, each of which can contain the name of the activity that is configured incorrectly, a descriptive message, an error or warning code , and other information.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
diff --git a/xml/System.Activities.Validation/ValidationSettings.xml b/xml/System.Activities.Validation/ValidationSettings.xml
index ecb5625961e..e0cd5c4dff8 100644
--- a/xml/System.Activities.Validation/ValidationSettings.xml
+++ b/xml/System.Activities.Validation/ValidationSettings.xml
@@ -134,11 +134,11 @@
if the additional constraints are to be used exclusively; otherwise, .
- is called whenever a workflow is executed, and any resulting errors will cause a to be thrown.
-
+ is called whenever a workflow is executed, and any resulting errors will cause a to be thrown.
+
]]>
diff --git a/xml/System.Activities/Activity.xml b/xml/System.Activities/Activity.xml
index 0114a8abd1d..2d5d2ab640d 100644
--- a/xml/System.Activities/Activity.xml
+++ b/xml/System.Activities/Activity.xml
@@ -22,17 +22,17 @@
An abstract base class used to create composite activities from pre-existing objects.
- is the base class in the activity type hierarchy. All other activity types such as , , , , and derive from this class.
-
-
-
-## Examples
- The following example shows a simple implementation of an derived class.
-
-
+ is the base class in the activity type hierarchy. All other activity types such as , , , , and derive from this class.
+
+
+
+## Examples
+ The following example shows a simple implementation of an derived class.
+
+
]]>
@@ -103,11 +103,11 @@
The activity's metadata that encapsulates the activity's arguments, variables, child activities, and activity delegates.
Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.
- to ensure correct construction of a workflow as well as to manage runtime relationships and lifetime rules. The default implementation of examines the public properties of the activity type using the type's . These public members are of type , , `IEnumerable`, , `IEnumerable`, or . You can override this method to customize the building of the activity's run-time description and to provide custom validation logic.
-
+ to ensure correct construction of a workflow as well as to manage runtime relationships and lifetime rules. The default implementation of examines the public properties of the activity type using the type's . These public members are of type , , `IEnumerable`, , `IEnumerable`, or . You can override this method to customize the building of the activity's run-time description and to provide custom validation logic.
+
]]>
@@ -152,11 +152,11 @@
Gets or sets an optional friendly name that is used for debugging, validation, exception handling, and tracking.
A friendly name that is used for debugging, validation, exception handling, and tracking.
-
@@ -180,11 +180,11 @@
Gets an identifier that is unique in the scope of the workflow definition.
An identifier that is unique in the scope of the workflow definition.
- is used in tracking and validation.
-
+ is used in tracking and validation.
+
]]>
@@ -234,11 +234,11 @@
Gets or sets the delegate that returns an that contains the execution logic.
The delegate that contains the execution logic.
-
diff --git a/xml/System.Activities/ActivityAction.xml b/xml/System.Activities/ActivityAction.xml
index 31649679497..5941e185e44 100644
--- a/xml/System.Activities/ActivityAction.xml
+++ b/xml/System.Activities/ActivityAction.xml
@@ -16,13 +16,13 @@
Defines an activity delegate that has no in arguments and does not return a value.
- activity that requires an iteration variable or the activity that requires an .
-
- There are multiple generic versions of this type that take from 1 to 16 arguments for the activity that is called. There are also types for delegates that return values.
-
+ activity that requires an iteration variable or the activity that requires an .
+
+ There are multiple generic versions of this type that take from 1 to 16 arguments for the activity that is called. There are also types for delegates that return values.
+
]]>
diff --git a/xml/System.Activities/ActivityDelegate.xml b/xml/System.Activities/ActivityDelegate.xml
index ceb67e00ae6..d33dbf95fce 100644
--- a/xml/System.Activities/ActivityDelegate.xml
+++ b/xml/System.Activities/ActivityDelegate.xml
@@ -22,11 +22,11 @@
Represents an activity-based callback.
- is used for invoking activities that do not have a return value, and is used for invoking activities that do have a return value. Activity delegates are useful in scenarios where a child activity must be constrained to having a certain signature.
-
+ is used for invoking activities that do not have a return value, and is used for invoking activities that do have a return value. Activity delegates are useful in scenarios where a child activity must be constrained to having a certain signature.
+
]]>
@@ -73,11 +73,11 @@
Gets or sets an optional friendly name that is used for debugging, validation, exception handling, and tracking.
A friendly name that is used for debugging, validation, exception handling, and tracking.
- is thrown.
-
+ is thrown.
+
]]>
@@ -137,11 +137,11 @@
Gets or sets the activity that is represented by this .
The activity that is represented by this .
- is thrown.
-
+ is thrown.
+
]]>
@@ -168,11 +168,11 @@
The list to be populated with runtime arguments.
Supplies a list of runtime arguments for the .
- .
-
+ .
+
]]>
@@ -204,11 +204,11 @@
, if the property value should be serialized; otherwise, .
- returns `true` if the was explicitly set on the .
-
+ returns `true` if the was explicitly set on the .
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`1.xml b/xml/System.Activities/ActivityFunc`1.xml
index 05e786d1468..dc27257bcd2 100644
--- a/xml/System.Activities/ActivityFunc`1.xml
+++ b/xml/System.Activities/ActivityFunc`1.xml
@@ -20,13 +20,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with no arguments and one argument of type Tresult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`10.xml b/xml/System.Activities/ActivityFunc`10.xml
index 0b3c4d7f082..f3df2c956ac 100644
--- a/xml/System.Activities/ActivityFunc`10.xml
+++ b/xml/System.Activities/ActivityFunc`10.xml
@@ -38,13 +38,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with nine in arguments of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`11.xml b/xml/System.Activities/ActivityFunc`11.xml
index 476ccfcc79d..b037c08d483 100644
--- a/xml/System.Activities/ActivityFunc`11.xml
+++ b/xml/System.Activities/ActivityFunc`11.xml
@@ -40,13 +40,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with one in argument of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus an `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus an `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`12.xml b/xml/System.Activities/ActivityFunc`12.xml
index 27603ddec98..92f54ecfa00 100644
--- a/xml/System.Activities/ActivityFunc`12.xml
+++ b/xml/System.Activities/ActivityFunc`12.xml
@@ -42,13 +42,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with one in argument of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`13.xml b/xml/System.Activities/ActivityFunc`13.xml
index 9ce059d53a9..e1cf8bbdc03 100644
--- a/xml/System.Activities/ActivityFunc`13.xml
+++ b/xml/System.Activities/ActivityFunc`13.xml
@@ -44,13 +44,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with one in argument of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`14.xml b/xml/System.Activities/ActivityFunc`14.xml
index 8ad985b1a42..bdde911ceb3 100644
--- a/xml/System.Activities/ActivityFunc`14.xml
+++ b/xml/System.Activities/ActivityFunc`14.xml
@@ -46,13 +46,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with one in argument of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`15.xml b/xml/System.Activities/ActivityFunc`15.xml
index b6a918f1b7b..43334f6fd46 100644
--- a/xml/System.Activities/ActivityFunc`15.xml
+++ b/xml/System.Activities/ActivityFunc`15.xml
@@ -48,13 +48,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with one in argument of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`16.xml b/xml/System.Activities/ActivityFunc`16.xml
index b8ad4a8241d..cc8cd42ddd3 100644
--- a/xml/System.Activities/ActivityFunc`16.xml
+++ b/xml/System.Activities/ActivityFunc`16.xml
@@ -50,13 +50,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with one in argument of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`17.xml b/xml/System.Activities/ActivityFunc`17.xml
index a2221ed68f1..80efd86a004 100644
--- a/xml/System.Activities/ActivityFunc`17.xml
+++ b/xml/System.Activities/ActivityFunc`17.xml
@@ -52,13 +52,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with one in argument of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`2.xml b/xml/System.Activities/ActivityFunc`2.xml
index 74eb1148d03..a93ad399800 100644
--- a/xml/System.Activities/ActivityFunc`2.xml
+++ b/xml/System.Activities/ActivityFunc`2.xml
@@ -22,13 +22,13 @@
The type of the argument of the activity delegate.
Defines an activity delegate with one in argument of type and one argument of type .
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`3.xml b/xml/System.Activities/ActivityFunc`3.xml
index f5f68cf82d2..97961be9fe3 100644
--- a/xml/System.Activities/ActivityFunc`3.xml
+++ b/xml/System.Activities/ActivityFunc`3.xml
@@ -24,13 +24,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with one in argument of type T and one argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`4.xml b/xml/System.Activities/ActivityFunc`4.xml
index e641e08b2d5..bac6ff103eb 100644
--- a/xml/System.Activities/ActivityFunc`4.xml
+++ b/xml/System.Activities/ActivityFunc`4.xml
@@ -26,13 +26,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with three in arguments of type T and one argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`5.xml b/xml/System.Activities/ActivityFunc`5.xml
index 1c7c8d4401f..a5b0cfbdf7a 100644
--- a/xml/System.Activities/ActivityFunc`5.xml
+++ b/xml/System.Activities/ActivityFunc`5.xml
@@ -28,13 +28,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with four in arguments of type T and one argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`6.xml b/xml/System.Activities/ActivityFunc`6.xml
index a9e84d22646..0e25e2023a0 100644
--- a/xml/System.Activities/ActivityFunc`6.xml
+++ b/xml/System.Activities/ActivityFunc`6.xml
@@ -30,13 +30,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with five in arguments of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`7.xml b/xml/System.Activities/ActivityFunc`7.xml
index 6b4fdf8c30c..82d19ab263d 100644
--- a/xml/System.Activities/ActivityFunc`7.xml
+++ b/xml/System.Activities/ActivityFunc`7.xml
@@ -32,13 +32,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with six in arguments of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`8.xml b/xml/System.Activities/ActivityFunc`8.xml
index 40ec7ba6274..d473a622cef 100644
--- a/xml/System.Activities/ActivityFunc`8.xml
+++ b/xml/System.Activities/ActivityFunc`8.xml
@@ -34,13 +34,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with seven in arguments of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityFunc`9.xml b/xml/System.Activities/ActivityFunc`9.xml
index 88dac981ddc..24fc3a45fab 100644
--- a/xml/System.Activities/ActivityFunc`9.xml
+++ b/xml/System.Activities/ActivityFunc`9.xml
@@ -36,13 +36,13 @@
The type of the out argument of the activity delegate.
Defines an activity delegate with eight in arguments of type T and one out argument of type TResult.
- enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
-
- There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
-
+ enables activity authors to expose callbacks with specific signatures that users of the activity can provide activity-based handlers for. is an that returns a value. The signature of the is specified as generic type arguments.
+
+ There are multiple generic versions of this type that take from 1 to 16 in arguments, plus the `out` argument, for the activity that is called. There are also **ActivityAction** types for activity delegates that do not return values.
+
]]>
diff --git a/xml/System.Activities/ActivityMetadata.xml b/xml/System.Activities/ActivityMetadata.xml
index df068c36a44..4601578e401 100644
--- a/xml/System.Activities/ActivityMetadata.xml
+++ b/xml/System.Activities/ActivityMetadata.xml
@@ -72,11 +72,11 @@
The function that returns the extension.
Adds the specified extension provider to the collection of default extension providers for the activity.
-
@@ -112,11 +112,11 @@
The activity to add.
Adds the specified activity to the metadata's list of imported child activities.
-
@@ -178,11 +178,11 @@
The delegate to add.
Adds the specified delegate to the metadata's list of imported delegates.
- is an that the parent activity does not invoke directly. Rather, the parent uses this to configure some other child activity.
-
+ is an that the parent activity does not invoke directly. Rather, the parent uses this to configure some other child activity.
+
]]>
@@ -221,11 +221,11 @@
Adds a validation error to the metadata's collection of validation errors.
-
@@ -252,11 +252,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The validation error to add.
Adds the specified validation error to the metadata's collection of validation errors.
-
@@ -283,11 +283,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
A message that describes the validation error.
Adds a validation error to the metadata's collection of validation errors using the specified description.
-
@@ -323,11 +323,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The variable to add.
Adds the specified variable to the metadata's collection of variables.
- adds the variables in its collection using this method. An activity's implementation cannot access variables added using this method. Activities added through (and any of their non-implementation child activities) can access variables added using this method. For example, adds its collection in this manner.
-
+ adds the variables in its collection using this method. An activity's implementation cannot access variables added using this method. Activities added through (and any of their non-implementation child activities) can access variables added using this method. For example, adds its collection in this manner.
+
]]>
@@ -457,11 +457,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
Returns a collection of arguments obtained by using reflection.
A collection of arguments.
- to examine all public properties of type and returns them in a collection.
-
+ to examine all public properties of type and returns them in a collection.
+
]]>
@@ -508,11 +508,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
Returns a collection of imported child activities using reflection.
A collection of imported child activities.
- to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
-
+ to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
+
]]>
@@ -537,11 +537,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
Returns a collection of delegates using reflection.
A collection of delegates.
- to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
-
+ to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
+
]]>
@@ -566,11 +566,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
Returns a collection of variables using reflection.
A collection of variables.
- to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
-
+ to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
+
]]>
@@ -675,11 +675,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The type of the extension.
Specifies that the activity requires an extension of the specified type at runtime.
-
@@ -711,11 +711,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The type of the extension.
Specifies that the activity requires an extension of the specified generic type at runtime.
-
@@ -766,11 +766,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The activities to add.
Adds the specified collection as imported child activities of the activity.
- for each item in the collection.
-
+ for each item in the collection.
+
]]>
@@ -797,11 +797,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The delegates to add.
Adds the specified collection as imported delegates of the activity.
- for each item in the collection.
-
+ for each item in the collection.
+
]]>
diff --git a/xml/System.Activities/Activity`1.xml b/xml/System.Activities/Activity`1.xml
index 3797dde88cf..5c58391e1fb 100644
--- a/xml/System.Activities/Activity`1.xml
+++ b/xml/System.Activities/Activity`1.xml
@@ -30,18 +30,18 @@
The type of the return value of the activity.
An abstract base class used to create composite activities from pre-existing objects, which specifies a result type using the activity's type specifier.
- is the base class in the activity type hierarchy. All other activity types with generic type definitions such as , , , and derive from this class.
-
-
-
-## Examples
- The following example shows how to derive a class from .
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/helloworld/cs/appendstring.cs" id="Snippet0":::
-
+ is the base class in the activity type hierarchy. All other activity types with generic type definitions such as , , , and derive from this class.
+
+
+
+## Examples
+ The following example shows how to derive a class from .
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/helloworld/cs/appendstring.cs" id="Snippet0":::
+
]]>
@@ -126,11 +126,11 @@
Returns a expression that evaluates to the given .
A workflow expression that evaluates to the given variable.
- is not compatible with the type of the , then an is thrown.
-
+ is not compatible with the type of the , then an is thrown.
+
]]>
@@ -189,11 +189,11 @@
Returns a expression that evaluates to the given .
A workflow expression that evaluates to the given variable.
- is not compatible with the type of the , then an is thrown.
-
+ is not compatible with the type of the , then an is thrown.
+
]]>
@@ -293,11 +293,11 @@
Gets or sets the result argument for the .
The result argument for the .
- is thrown.
-
+ is thrown.
+
]]>
diff --git a/xml/System.Activities/Argument.xml b/xml/System.Activities/Argument.xml
index fbbdaca8fc2..69f7470964f 100644
--- a/xml/System.Activities/Argument.xml
+++ b/xml/System.Activities/Argument.xml
@@ -159,11 +159,11 @@
Gets or sets a zero-based value that specifies the order in which the argument is evaluated.
A zero-based value that specifies the order in which the argument is evaluated.
- value. Set to a value greater or equal to zero to specify an evaluation order for this argument. Windows Workflow Foundation evaluates arguments with a specified evaluation order in ascending order. Note that arguments with an unspecified evaluation order are evaluated before those with a specified evaluation order.
-
+ value. Set to a value greater or equal to zero to specify an evaluation order for this argument. Windows Workflow Foundation evaluates arguments with a specified evaluation order in ascending order. Note that arguments with an unspecified evaluation order are evaluated before those with a specified evaluation order.
+
]]>
The value is less than zero and not equal to .
@@ -311,11 +311,11 @@
Represents the constant value of "Result", which corresponds to the name of the property of type in the expression base class .
-
diff --git a/xml/System.Activities/ArgumentDirection.xml b/xml/System.Activities/ArgumentDirection.xml
index abb1c89ff1d..a38d330c8bd 100644
--- a/xml/System.Activities/ArgumentDirection.xml
+++ b/xml/System.Activities/ArgumentDirection.xml
@@ -15,15 +15,15 @@
Specifies the direction of data flow for an .
- of type is created using the method of the class.
-
-```csharp
-Argument a = Argument.Create(typeof(string), ArgumentDirection.In);
-```
-
+ of type is created using the method of the class.
+
+```csharp
+Argument a = Argument.Create(typeof(string), ArgumentDirection.In);
+```
+
]]>
diff --git a/xml/System.Activities/AsyncCodeActivity.xml b/xml/System.Activities/AsyncCodeActivity.xml
index 133d7b61437..26fdae7c423 100644
--- a/xml/System.Activities/AsyncCodeActivity.xml
+++ b/xml/System.Activities/AsyncCodeActivity.xml
@@ -16,13 +16,13 @@
Manages asynchronous code activity execution from start to completion. This is an abstract class.
- to create a custom activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/async/cs/filewriter.cs" id="Snippet0":::
-
+ to create a custom activity.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/async/cs/filewriter.cs" id="Snippet0":::
+
]]>
@@ -77,13 +77,13 @@
When implemented in a derived class and using the specified execution context, callback method, and user state, enqueues an asynchronous activity in a run-time workflow.
The object that saves variable information for an instance of an asynchronous activity.
- method in a custom activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/async/cs/filewriter.cs" id="Snippet1":::
-
+ method in a custom activity.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/async/cs/filewriter.cs" id="Snippet1":::
+
]]>
@@ -96,11 +96,11 @@
Serves as a virtual method and converts information obtained by cache reflection into arguments for an asynchronous activity.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -152,11 +152,11 @@
object that contains data for a set of asynchronous activity arguments.
Serves as a virtual method and converts information obtained by cache reflection into arguments for an asynchronous activity.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -209,13 +209,13 @@
The implemented that returns the status of an asynchronous activity when execution ends.
When implemented in a derived class and using the specified execution environment information, notifies the workflow runtime that the associated asynchronous activity operation has completed.
- method in a custom activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/async/cs/filewriter.cs" id="Snippet2":::
-
+ method in a custom activity.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/async/cs/filewriter.cs" id="Snippet2":::
+
]]>
diff --git a/xml/System.Activities/AsyncCodeActivity`1.xml b/xml/System.Activities/AsyncCodeActivity`1.xml
index 743ea9cb025..f65849baf89 100644
--- a/xml/System.Activities/AsyncCodeActivity`1.xml
+++ b/xml/System.Activities/AsyncCodeActivity`1.xml
@@ -85,11 +85,11 @@
Serves as a virtual method and converts information obtained by cache reflection into arguments for an asynchronous activity.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -141,11 +141,11 @@
object that contains data for a set of asynchronous activity arguments.
Serves as a virtual method and converts information obtained by reflection on a cache into arguments for an asynchronous activity.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
diff --git a/xml/System.Activities/Bookmark.xml b/xml/System.Activities/Bookmark.xml
index 157c706537c..cdc508e69fa 100644
--- a/xml/System.Activities/Bookmark.xml
+++ b/xml/System.Activities/Bookmark.xml
@@ -26,110 +26,110 @@
Represents a point at which a workflow or activity can passively wait to be resumed.
- , it becomes idle and waits for the to be resumed. If there are other activities in parallel with the activity that created the , they will be scheduled for execution.
-
- Bookmarks can be resumed by the host application using one of the overloads.
-
+ , it becomes idle and waits for the to be resumed. If there are other activities in parallel with the activity that created the , they will be scheduled for execution.
+
+ Bookmarks can be resumed by the host application using one of the overloads.
+
For more information about bookmarks, see [Using WorkflowInvoker and WorkflowApplication](/dotnet/framework/windows-workflow-foundation/using-workflowinvoker-and-workflowapplication) and [Bookmarks](/dotnet/framework/windows-workflow-foundation/bookmarks).
-
-## Examples
- In the following example, a `ReadLine` activity is created. When executed, the `ReadLine` activity creates a , registers a callback, and then waits for the to be resumed. When it is resumed, the `ReadLine` activity assigns the data that was passed with the to its argument.
-
-```csharp
-public sealed class ReadLine : NativeActivity
-{
- [RequiredArgument]
- public InArgument 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);
- }
-}
-```
-
- In the following example, a workflow is created that uses the `ReadLine` activity to gather the user's name and display it to the console window. The host application performs the actual work of gathering the input and passes it to the workflow by resuming the .
-
-```csharp
-Variable name = new Variable
-{
- 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((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();
-```
-
- When the `ReadLine` activity is executed, it creates a named `UserName` and then waits for the bookmark to be resumed. The host collects the desired data and then resumes the . The workflow resumes, displays the name, and then completes. Note that no synchronization code is required with regard to resuming the bookmark. A can only be resumed when the workflow is idle, and if the workflow is not idle, the call to blocks until the workflow becomes idle.
-
+
+## Examples
+ In the following example, a `ReadLine` activity is created. When executed, the `ReadLine` activity creates a , registers a callback, and then waits for the to be resumed. When it is resumed, the `ReadLine` activity assigns the data that was passed with the to its argument.
+
+```csharp
+public sealed class ReadLine : NativeActivity
+{
+ [RequiredArgument]
+ public InArgument 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);
+ }
+}
+```
+
+ In the following example, a workflow is created that uses the `ReadLine` activity to gather the user's name and display it to the console window. The host application performs the actual work of gathering the input and passes it to the workflow by resuming the .
+
+```csharp
+Variable name = new Variable
+{
+ 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((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();
+```
+
+ When the `ReadLine` activity is executed, it creates a named `UserName` and then waits for the bookmark to be resumed. The host collects the desired data and then resumes the . The workflow resumes, displays the name, and then completes. Note that no synchronization code is required with regard to resuming the bookmark. A can only be resumed when the workflow is idle, and if the workflow is not idle, the call to blocks until the workflow becomes idle.
+
]]>
diff --git a/xml/System.Activities/BookmarkOptions.xml b/xml/System.Activities/BookmarkOptions.xml
index 8fe18cd2084..7606af0c09a 100644
--- a/xml/System.Activities/BookmarkOptions.xml
+++ b/xml/System.Activities/BookmarkOptions.xml
@@ -21,14 +21,14 @@
Specifies the options for a .
- , , and .
+By default, the workflow runtime removes a pending bookmark from its bookmarks table when resuming the bookmark. However if the bookmark is specified as `MultipleResume`, the bookmark is not removed from the table, and the same bookmark can be resumed multiple times. An example usage of `MultipleResume` is by looping activities such as , , and .
+
+By default, the workflow runtime does not consider an activity to have completed execution if it has pending bookmarks. However, if a bookmark is specified as `NonBlocking` at creation time, the workflow runtime allows the activity to complete execution even if it has pending `NonBlocking` bookmarks, provided it has no other pending work.
-By default, the workflow runtime does not consider an activity to have completed execution if it has pending bookmarks. However, if a bookmark is specified as `NonBlocking` at creation time, the workflow runtime allows the activity to complete execution even if it has pending `NonBlocking` bookmarks, provided it has no other pending work.
-
]]>
diff --git a/xml/System.Activities/CodeActivity.xml b/xml/System.Activities/CodeActivity.xml
index b330e126613..376a175467f 100644
--- a/xml/System.Activities/CodeActivity.xml
+++ b/xml/System.Activities/CodeActivity.xml
@@ -16,13 +16,13 @@
An abstract class for creating a custom activity with imperative behavior defined with the method, which gives access to variable and argument resolution and extensions.
- -derived activity.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/activityaction/cs/messagebox.cs" id="Snippet0":::
-
+ -derived activity.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/activityaction/cs/messagebox.cs" id="Snippet0":::
+
]]>
@@ -58,11 +58,11 @@
Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -89,11 +89,11 @@
Not implemented.
Not implemented. Use instead.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -120,11 +120,11 @@
The activity's metadata that encapsulates the activity's arguments, variables, child activities, and activity delegates.
Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.
- to ensure correct construction of a workflow as well as to manage runtime relationships and lifetime rules. The default implementation of examines the public members of the activity type using the type's . These public members are of type , , [IEnumerable\](xref:System.Collections.Generic.IEnumerable%601), , [IEnumerable\](xref:System.Collections.Generic.IEnumerable%601), or . You can override this method to customize the building of the activity's run-time description and to provide custom validation logic. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ to ensure correct construction of a workflow as well as to manage runtime relationships and lifetime rules. The default implementation of examines the public members of the activity type using the type's . These public members are of type , , [IEnumerable\](xref:System.Collections.Generic.IEnumerable`1), , [IEnumerable\](xref:System.Collections.Generic.IEnumerable`1), or . You can override this method to customize the building of the activity's run-time description and to provide custom validation logic. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -178,11 +178,11 @@ The workflow runtime uses the default implementation of Not supported.
Always returns .
- . does not allow defining the execution logic as an activity. Instead the execution logic must be defined in the method.
-
+ . does not allow defining the execution logic as an activity. Instead the execution logic must be defined in the method.
+
]]>
diff --git a/xml/System.Activities/CodeActivity`1.xml b/xml/System.Activities/CodeActivity`1.xml
index b56625bfad3..0a4d1dd9561 100644
--- a/xml/System.Activities/CodeActivity`1.xml
+++ b/xml/System.Activities/CodeActivity`1.xml
@@ -23,18 +23,18 @@
The result returned by the activity.
An abstract class for creating a custom activity with imperative behavior defined in the method, giving access to variable and argument resolution and extensions.
- .
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/workflowinvoker/cs/add.cs" id="Snippet0":::
-
+ .
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/workflowinvoker/cs/add.cs" id="Snippet0":::
+
]]>
@@ -70,11 +70,11 @@
Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -101,11 +101,11 @@
Not implemented.
Not implemented. Use instead.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -132,10 +132,10 @@
The activity's metadata that encapsulates the activity's arguments, variables, child activities, and activity delegates.
Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.
- to ensure correct construction of a workflow as well as to manage run-time relationships and lifetime rules. The default implementation of examines the public members of the activity type using the type's . These public members are of type , , [IEnumerable\](xref:System.Collections.Generic.IEnumerable%601), , [IEnumerable\](xref:System.Collections.Generic.IEnumerable%601), or . You can override this method to customize the building of the activity's run-time description and to provide custom validation logic. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+ to ensure correct construction of a workflow as well as to manage run-time relationships and lifetime rules. The default implementation of examines the public members of the activity type using the type's . These public members are of type , , [IEnumerable\](xref:System.Collections.Generic.IEnumerable`1), , [IEnumerable\](xref:System.Collections.Generic.IEnumerable`1), or . You can override this method to customize the building of the activity's run-time description and to provide custom validation logic. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
]]>
@@ -191,11 +191,11 @@
Not supported.
Always returns .
- . does not allow defining the execution logic as an activity. Instead the execution logic must be defined in the method.
-
+ . does not allow defining the execution logic as an activity. Instead the execution logic must be defined in the method.
+
]]>
diff --git a/xml/System.Activities/DynamicActivity`1.xml b/xml/System.Activities/DynamicActivity`1.xml
index 295b7422925..5640762cb41 100644
--- a/xml/System.Activities/DynamicActivity`1.xml
+++ b/xml/System.Activities/DynamicActivity`1.xml
@@ -33,11 +33,11 @@
The result returned by the activity.
Provides an approach that is consistent with the document object model (DOM), which constructs activities dynamically that interface with the WF designer and workflow runtime using .
- you can create new activities without creating new types. with its associated XAML support in allows new arguments to be defined in XAML and bound by the host without requiring XAML to be compiled.
-
+ you can create new activities without creating new types. with its associated XAML support in allows new arguments to be defined in XAML and bound by the host without requiring XAML to be compiled.
+
]]>
@@ -258,11 +258,11 @@
Returns a collection of attributes of the dynamic activity.
The attributes of the dynamic activity.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -290,11 +290,11 @@
Returns the class name of the dynamic activity.
The class name.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -322,11 +322,11 @@
Returns the component name of the dynamic activity.
The component name.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -354,11 +354,11 @@
Returns a type converter for the dynamic activity.
A type converter for this dynamic activity instance.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -386,11 +386,11 @@
Returns the default event for the dynamic activity.
The default event.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -418,11 +418,11 @@
Returns the default property for the dynamic activity.
The default property.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -453,11 +453,11 @@
Returns an editor with the specified base type.
An instance of the editor that can be cast to the specified editor type, or if no editor of the requested type can be found.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -494,11 +494,11 @@
Returns the collection of events of the dynamic activity.
The collection of events.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -529,11 +529,11 @@
Returns the collection of events of the dynamic activity using a specified array of attributes as a filter.
The collection of events that match the specified attributes.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -570,11 +570,11 @@
Returns the collection of properties of the dynamic activity.
The collection of properties.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -605,11 +605,11 @@
Returns the collection of properties of the dynamic activity using a specified array of attributes as a filter.
The collection of properties that match the specified attributes.
- instance is cast to an interface.
-
+ instance is cast to an interface.
+
]]>
@@ -640,13 +640,13 @@
Returns this instance of the class.
This instance of .
- interface.
-
- This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
-
+ interface.
+
+ This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
+
]]>
diff --git a/xml/System.Activities/ExecutionProperties.xml b/xml/System.Activities/ExecutionProperties.xml
index 03bd21ab6e8..a1b6e98dbc7 100644
--- a/xml/System.Activities/ExecutionProperties.xml
+++ b/xml/System.Activities/ExecutionProperties.xml
@@ -23,15 +23,15 @@
Represents the collection of properties at a particular scope.
-
@@ -134,11 +134,11 @@
Returns the nearest property of the given name.
The nearest property of the given name.
- finds the nearest visible property using hierarchical scoping. If two properties have the same name, the closest property at the parent scope is returned.
-
+ finds the nearest visible property using hierarchical scoping. If two properties have the same name, the closest property at the parent scope is returned.
+
]]>
@@ -220,11 +220,11 @@
if the property was unregistered; otherwise, .
-
diff --git a/xml/System.Activities/Handle.xml b/xml/System.Activities/Handle.xml
index 91c6eea15fc..6e2c1cdc03b 100644
--- a/xml/System.Activities/Handle.xml
+++ b/xml/System.Activities/Handle.xml
@@ -22,11 +22,11 @@
Represents a type that has its lifetime controlled by the workflow runtime.
- have their lifetimes controlled by the workflow runtime. For workflow variables of handle types, the runtime uses the required parameterless constructor to create an instance of the type, assigns it to the , and calls when initializing the environment. When the variable goes out of scope, is called.
-
+ have their lifetimes controlled by the workflow runtime. For workflow variables of handle types, the runtime uses the required parameterless constructor to create an instance of the type, assigns it to the , and calls when initializing the environment. When the variable goes out of scope, is called.
+
]]>
@@ -46,11 +46,11 @@
Initializes a new instance of the class.
- must provide a parameterless constructor.
-
+ must provide a parameterless constructor.
+
]]>
@@ -170,11 +170,11 @@
Throws an if the has not been initialized.
- gives custom handle derived class authors a convenient method to call from any methods or properties of the derived class that are not valid if the is uninitialized.
-
+ gives custom handle derived class authors a convenient method to call from any methods or properties of the derived class that are not valid if the is uninitialized.
+
]]>
diff --git a/xml/System.Activities/InArgument`1.xml b/xml/System.Activities/InArgument`1.xml
index 12bb01c3d5b..99b2231d58f 100644
--- a/xml/System.Activities/InArgument`1.xml
+++ b/xml/System.Activities/InArgument`1.xml
@@ -34,21 +34,21 @@
The data type of the .
A binding terminal that represents the flow of data into an activity.
- activity. The activity has an named . The host application creates an instance of the workflow and passes a string, which maps to the argument of the and is used by the activity.
-
-```csharp
-Activity wf = new WriteLine();
-
-Dictionary wfParams = new Dictionary();
-wfParams.Add("Text", "Hello World!");
-
-WorkflowInvoker.Invoke(wf, wfParams);
-
-```
-
+ activity. The activity has an named . The host application creates an instance of the workflow and passes a string, which maps to the argument of the and is used by the activity.
+
+```csharp
+Activity wf = new WriteLine();
+
+Dictionary wfParams = new Dictionary();
+wfParams.Add("Text", "Hello World!");
+
+WorkflowInvoker.Invoke(wf, wfParams);
+
+```
+
]]>
@@ -182,11 +182,11 @@ WorkflowInvoker.Invoke(wf, wfParams);
The value of the argument.
Initializes a new instance of the class using the specified value.
- ` was provided as a `constValue` and three instances were created then all three instances would be accessing the same `List`.
-
+ ` was provided as a `constValue` and three instances were created then all three instances would be accessing the same `List`.
+
]]>
diff --git a/xml/System.Activities/InOutArgument`1.xml b/xml/System.Activities/InOutArgument`1.xml
index 315ab1f239a..525fca89a3a 100644
--- a/xml/System.Activities/InOutArgument`1.xml
+++ b/xml/System.Activities/InOutArgument`1.xml
@@ -34,57 +34,57 @@
The data type of the .
A binding terminal that represents the flow of data into and out of an activity.
- of type named `N1`. This argument is used to receive the value to be operated on and is also used to pass the result of the operation back out.
-
-```csharp
-class Square : CodeActivity
-{
- public Square() : base() { }
-
- public InOutArgument N1
- {
- get;
-
- set;
- }
-
- protected override void Execute(CodeActivityContext context)
- {
- context.SetValue(N1, N1.Get(context) * N1.Get(context));
- }
-}
-```
-
- In the following example, the `Square` activity is hosted in a workflow. A value is passed into the activity and the result is then displayed to the console window by a activity.
-
-```csharp
-Variable n1 = new Variable() { Default = 25 };
-
-Activity activity1 = new Sequence()
-{
- Variables =
- {
- n1
- },
- Activities =
- {
- new Square()
- {
- N1 = new InOutArgument(n1)
- },
- new WriteLine()
- {
- Text = new InArgument(ctx => "Squared result: " + n1.Get(ctx))
- }
- }
-};
-
-WorkflowInvoker.Invoke(activity1);
-```
-
+ of type named `N1`. This argument is used to receive the value to be operated on and is also used to pass the result of the operation back out.
+
+```csharp
+class Square : CodeActivity
+{
+ public Square() : base() { }
+
+ public InOutArgument N1
+ {
+ get;
+
+ set;
+ }
+
+ protected override void Execute(CodeActivityContext context)
+ {
+ context.SetValue(N1, N1.Get(context) * N1.Get(context));
+ }
+}
+```
+
+ In the following example, the `Square` activity is hosted in a workflow. A value is passed into the activity and the result is then displayed to the console window by a activity.
+
+```csharp
+Variable n1 = new Variable() { Default = 25 };
+
+Activity activity1 = new Sequence()
+{
+ Variables =
+ {
+ n1
+ },
+ Activities =
+ {
+ new Square()
+ {
+ N1 = new InOutArgument(n1)
+ },
+ new WriteLine()
+ {
+ Text = new InArgument(ctx => "Squared result: " + n1.Get(ctx))
+ }
+ }
+};
+
+WorkflowInvoker.Invoke(activity1);
+```
+
]]>
diff --git a/xml/System.Activities/InvokeCompletedEventArgs.xml b/xml/System.Activities/InvokeCompletedEventArgs.xml
index afb3664f7e6..b5e075df468 100644
--- a/xml/System.Activities/InvokeCompletedEventArgs.xml
+++ b/xml/System.Activities/InvokeCompletedEventArgs.xml
@@ -16,11 +16,11 @@
Provides data for the event.
- overloads in , workflow host authors can handle to get data from the completed workflow, or exception data if the workflow failed to complete.
-
+ overloads in , workflow host authors can handle to get data from the completed workflow, or exception data if the workflow failed to complete.
+
]]>
@@ -50,11 +50,11 @@
Gets an of the root activity's output argument values from the completed workflow.
A dictionary of the root activity's output argument values from the completed workflow.
-
diff --git a/xml/System.Activities/Location.xml b/xml/System.Activities/Location.xml
index f4044032d8e..83769872bd0 100644
--- a/xml/System.Activities/Location.xml
+++ b/xml/System.Activities/Location.xml
@@ -101,11 +101,11 @@
Gets or sets the value of the referenced object.
The value of the object.
- to get and set the value, which is implemented in derived classes.
-
+ to get and set the value, which is implemented in derived classes.
+
]]>
diff --git a/xml/System.Activities/Location`1.xml b/xml/System.Activities/Location`1.xml
index e0b82ab3d6c..22c29ace909 100644
--- a/xml/System.Activities/Location`1.xml
+++ b/xml/System.Activities/Location`1.xml
@@ -92,11 +92,11 @@
Returns the string representation of the value of the referenced object.
The value of the referenced object.
- ".
-
+ ".
+
]]>
@@ -151,11 +151,11 @@
Gets or sets the value of the referenced object.
The value of the referenced object.
- to get and set the value, which is implemented in derived classes.
-
+ to get and set the value, which is implemented in derived classes.
+
]]>
diff --git a/xml/System.Activities/NativeActivity.xml b/xml/System.Activities/NativeActivity.xml
index ee7232fedad..5d4c7026cbd 100644
--- a/xml/System.Activities/NativeActivity.xml
+++ b/xml/System.Activities/NativeActivity.xml
@@ -16,79 +16,79 @@
Abstract base class for custom activities that implement execution logic using the method, which has full access to the runtime's features.
- . This example is from the [Custom Composite using Native Activity](/dotnet/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity) sample.
-
+ . This example is from the [Custom Composite using Native Activity](/dotnet/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity) sample.
+
```csharp
-public sealed class MySequence : NativeActivity
-{
- Collection children;
- Collection variables;
- Variable currentIndex;
- CompletionCallback onChildComplete;
-
- public MySequence()
- : base()
- {
- this.children = new Collection();
- this.variables = new Collection();
- this.currentIndex = new Variable();
- }
-
- public Collection Activities
- {
- get
- {
- return this.children;
- }
- }
- public Collection Variables
- {
- get
- {
- return this.variables;
- }
- }
- protected override void CacheMetadata(NativeActivityMetadata metadata)
- {
- //call base.CacheMetadata to add the Activities and Variables to this activity's metadata
- base.CacheMetadata(metadata);
- //add the private implementation variable: currentIndex
- metadata.AddImplementationVariable(this.currentIndex);
- }
-
- protected override void Execute(NativeActivityContext context)
- {
- InternalExecute(context, null);
- }
- void InternalExecute(NativeActivityContext context, ActivityInstance instance)
- {
- //grab the index of the current Activity
- int currentActivityIndex = this.currentIndex.Get(context);
- if (currentActivityIndex == Activities.Count)
- {
- //if the currentActivityIndex is equal to the count of MySequence's Activities
- //MySequence is complete
- return;
- }
-
- if (this.onChildComplete == null)
- {
- //on completion of the current child, have the runtime call back on this method
- this.onChildComplete = new CompletionCallback(InternalExecute);
- }
- //grab the next Activity in MySequence.Activities and schedule it
- Activity nextChild = Activities[currentActivityIndex];
- context.ScheduleActivity(nextChild, this.onChildComplete);
-
- //increment the currentIndex
- this.currentIndex.Set(context, ++currentActivityIndex);
- }
-}
-```
-
+public sealed class MySequence : NativeActivity
+{
+ Collection children;
+ Collection variables;
+ Variable currentIndex;
+ CompletionCallback onChildComplete;
+
+ public MySequence()
+ : base()
+ {
+ this.children = new Collection();
+ this.variables = new Collection();
+ this.currentIndex = new Variable();
+ }
+
+ public Collection Activities
+ {
+ get
+ {
+ return this.children;
+ }
+ }
+ public Collection Variables
+ {
+ get
+ {
+ return this.variables;
+ }
+ }
+ protected override void CacheMetadata(NativeActivityMetadata metadata)
+ {
+ //call base.CacheMetadata to add the Activities and Variables to this activity's metadata
+ base.CacheMetadata(metadata);
+ //add the private implementation variable: currentIndex
+ metadata.AddImplementationVariable(this.currentIndex);
+ }
+
+ protected override void Execute(NativeActivityContext context)
+ {
+ InternalExecute(context, null);
+ }
+ void InternalExecute(NativeActivityContext context, ActivityInstance instance)
+ {
+ //grab the index of the current Activity
+ int currentActivityIndex = this.currentIndex.Get(context);
+ if (currentActivityIndex == Activities.Count)
+ {
+ //if the currentActivityIndex is equal to the count of MySequence's Activities
+ //MySequence is complete
+ return;
+ }
+
+ if (this.onChildComplete == null)
+ {
+ //on completion of the current child, have the runtime call back on this method
+ this.onChildComplete = new CompletionCallback(InternalExecute);
+ }
+ //grab the next Activity in MySequence.Activities and schedule it
+ Activity nextChild = Activities[currentActivityIndex];
+ context.ScheduleActivity(nextChild, this.onChildComplete);
+
+ //increment the currentIndex
+ this.currentIndex.Set(context, ++currentActivityIndex);
+ }
+}
+```
+
]]>
@@ -114,13 +114,13 @@ public sealed class MySequence : NativeActivity
When implemented in a derived class, creates a new instance of the derived class.
- . This example is from the [Custom Composite using Native Activity](/dotnet/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_customcompositenativeactivity/cs/mysequence.cs" id="Snippet1":::
-
+ . This example is from the [Custom Composite using Native Activity](/dotnet/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_customcompositenativeactivity/cs/mysequence.cs" id="Snippet1":::
+
]]>
@@ -157,11 +157,11 @@ public sealed class MySequence : NativeActivity
Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -188,11 +188,11 @@ public sealed class MySequence : NativeActivity
Not implemented.
Not implemented. Use the method instead.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -219,18 +219,18 @@ public sealed class MySequence : NativeActivity
The activity's metadata that encapsulates the activity's arguments, variables, child activities, and activity delegates.
Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.
- to ensure correct construction of a workflow as well as to manage run-time relationships and lifetime rules. The default implementation of examines the public members of the activity type using the type's . These public members are of type , , [IEnumerable\](xref:System.Collections.Generic.IEnumerable%601), , [IEnumerable\](xref:System.Collections.Generic.IEnumerable%601), or . You can override this method to customize the building of the activity's run-time description and to provide custom validation logic. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
-
-
-## Examples
- The following code sample demonstrates using CacheMetadata in a class that inherits from . This example is from the [Custom Composite using Native Activity](/dotnet/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_customcompositenativeactivity/cs/mysequence.cs" id="Snippet2":::
-
+ to ensure correct construction of a workflow as well as to manage run-time relationships and lifetime rules. The default implementation of examines the public members of the activity type using the type's . These public members are of type , , [IEnumerable\](xref:System.Collections.Generic.IEnumerable`1), , [IEnumerable\](xref:System.Collections.Generic.IEnumerable`1), or . You can override this method to customize the building of the activity's run-time description and to provide custom validation logic. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
+
+
+## Examples
+ The following code sample demonstrates using CacheMetadata in a class that inherits from . This example is from the [Custom Composite using Native Activity](/dotnet/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_customcompositenativeactivity/cs/mysequence.cs" id="Snippet2":::
+
]]>
@@ -257,13 +257,13 @@ public sealed class MySequence : NativeActivity
The execution context in which the activity executes.
When implemented in a derived class, runs logic to cause graceful early completion of the activity.
- . This example is from the [Non-Generic ParallelForEach](/dotnet/framework/windows-workflow-foundation/samples/non-generic-parallelforeach) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nongenericparallelforeach/cs/parallelforeach/parallelforeach.cs" id="Snippet2":::
-
+ . This example is from the [Non-Generic ParallelForEach](/dotnet/framework/windows-workflow-foundation/samples/non-generic-parallelforeach) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nongenericparallelforeach/cs/parallelforeach/parallelforeach.cs" id="Snippet2":::
+
]]>
@@ -312,13 +312,13 @@ public sealed class MySequence : NativeActivity
The execution context in which the activity executes.
When implemented in a derived class, runs the activity's execution logic.
- . This example is from the [Non-Generic ParallelForEach](/dotnet/framework/windows-workflow-foundation/samples/non-generic-parallelforeach) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nongenericparallelforeach/cs/parallelforeach/parallelforeach.cs" id="Snippet2":::
-
+ . This example is from the [Non-Generic ParallelForEach](/dotnet/framework/windows-workflow-foundation/samples/non-generic-parallelforeach) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nongenericparallelforeach/cs/parallelforeach/parallelforeach.cs" id="Snippet2":::
+
]]>
diff --git a/xml/System.Activities/NativeActivityAbortContext.xml b/xml/System.Activities/NativeActivityAbortContext.xml
index 8317ba52199..d4f8f4a9a5d 100644
--- a/xml/System.Activities/NativeActivityAbortContext.xml
+++ b/xml/System.Activities/NativeActivityAbortContext.xml
@@ -16,11 +16,11 @@
Represents the execution environment of an activity that is being aborted.
- can override to take action in response to being aborted. For example, an activity that interacts with might want to call if the activity is being aborted.
-
+ can override to take action in response to being aborted. For example, an activity that interacts with might want to call if the activity is being aborted.
+
]]>
diff --git a/xml/System.Activities/NativeActivityContext.xml b/xml/System.Activities/NativeActivityContext.xml
index 2cfed7d6e15..7ef798fc7e1 100644
--- a/xml/System.Activities/NativeActivityContext.xml
+++ b/xml/System.Activities/NativeActivityContext.xml
@@ -16,11 +16,11 @@
The execution context for a .
- is provided access to the advanced capabilities of the WF runtime via , which is passed as a parameter to the activity's method.
-
+ is provided access to the advanced capabilities of the WF runtime via , which is passed as a parameter to the activity's method.
+
]]>
@@ -313,13 +313,13 @@
Creates the point at which a can passively wait to be resumed, with the specified method to execute when notification of the resume operation completes and with the specified option that governs how the bookmark is used during the execution of the current .
A bookmark that includes the callback method and the bookmark execution option.
- , and .
-
- Bookmark callbacks can operate without bookmark options but bookmark options must always be paired with a callback because the options do not apply in situations where there is no callback method.
-
+ , and .
+
+ Bookmark callbacks can operate without bookmark options but bookmark options must always be paired with a callback because the options do not apply in situations where there is no callback method.
+
]]>
@@ -384,11 +384,11 @@
Creates the point at which a can passively wait to be resumed with the specified name, the specified method to execute when notification of the resume operation completes, and the specified option that governs how the bookmark is used during the execution of the current .
A bookmark that includes the name of the bookmark, the callback method, and the bookmark execution option.
-
@@ -426,11 +426,11 @@
Creates the point at which a can passively wait to be resumed with the specified name, the specified method to execute when notification of the resume operation completes, and the specified scope of the bookmark.
A bookmark that includes the name of the bookmark, the callback method, and the scope of the bookmark.
-
@@ -464,11 +464,11 @@
Creates the point at which a can passively wait to be resumed with the specified name, the specified method to execute when notification of the resume operation completes, the specified scope of the bookmark, and the specified option that governs how the bookmark is used during the execution of the current .
A bookmark that includes the name of the bookmark, the callback method, the scope of the bookmark, and the bookmark execution option.
-
diff --git a/xml/System.Activities/NativeActivityMetadata.xml b/xml/System.Activities/NativeActivityMetadata.xml
index 4994dc0db18..1002a111cd7 100644
--- a/xml/System.Activities/NativeActivityMetadata.xml
+++ b/xml/System.Activities/NativeActivityMetadata.xml
@@ -73,11 +73,11 @@
The activity to add.
Adds the specified activity to the metadata's list of child activities.
- is a child activity that the parent activity can schedule directly. These activities are to be provided by the consumer of the activity. An example of this is the collection of a activity. These activities (and any activities they add using or ) have access to variables added through .
-
+ is a child activity that the parent activity can schedule directly. These activities are to be provided by the consumer of the activity. An example of this is the collection of a activity. These activities (and any activities they add using or ) have access to variables added through .
+
]]>
@@ -138,11 +138,11 @@
The function that returns the extension.
Adds the specified extension provider to the collection of default extension providers for the activity.
-
@@ -228,11 +228,11 @@
The activity to add.
Adds the specified activity to the metadata's list of implementation activities.
- is a child activity that the parent activity can schedule directly. These activities are implementation details of the activity. These activities (and any activities they add using or ) have access to this activity's arguments as well as variables added through .
-
+ is a child activity that the parent activity can schedule directly. These activities are implementation details of the activity. These activities (and any activities they add using or ) have access to this activity's arguments as well as variables added through .
+
]]>
@@ -316,11 +316,11 @@
The activity to add.
Adds the specified activity to the metadata's list of imported child activities.
-
@@ -418,11 +418,11 @@
Adds a validation error to the metadata' collection of validation errors.
-
@@ -449,11 +449,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The validation error to add.
Adds the specified validation error to the metadata's collection of validation errors.
-
@@ -480,11 +480,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
A message that describes the validation error.
Adds a validation error to the metadata's collection of validation errors using the specified description.
-
@@ -520,11 +520,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The variable to add.
Adds the specified variable to the metadata's collection of variables.
- or (and any of their non-implementation child activities) can access variables added using this method.
-
+ or (and any of their non-implementation child activities) can access variables added using this method.
+
]]>
@@ -654,11 +654,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
Returns a collection of arguments obtained by using reflection.
A collection of arguments.
- to examine all public properties of type and returns them in a collection.
-
+ to examine all public properties of type and returns them in a collection.
+
]]>
@@ -683,11 +683,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
Returns a collection of child activities using reflection.
A collection of child activities.
- to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
-
+ to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
+
]]>
@@ -712,11 +712,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
Returns a collection of delegates using reflection.
A collection of delegates.
- to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
-
+ to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
+
]]>
@@ -763,11 +763,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
Returns a collection of variables using reflection.
A collection of variables.
- to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
-
+ to examine all public properties of type , or `IList` or `ICollection` where `T` derives from , and returns them in a collection.
+
]]>
@@ -872,11 +872,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The type of the extension.
Specifies that the activity requires an extension of the specified type at runtime.
-
@@ -908,11 +908,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The type of the extension.
Specifies that the activity requires an extension of the specified generic type at runtime.
-
@@ -963,11 +963,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The activities to add.
Adds the specified collection as child activities of the activity.
- for each item in the collection.
-
+ for each item in the collection.
+
]]>
@@ -994,11 +994,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The delegates to add.
Adds the specified collection as delegates of the activity.
- for each item in the collection.
-
+ for each item in the collection.
+
]]>
@@ -1025,11 +1025,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The activities to add.
Adds the specified collection as implementation child activities of the activity.
- for each item in the collection.
-
+ for each item in the collection.
+
]]>
@@ -1056,11 +1056,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The delegates to add.
Adds the specified collection as implementation delegates of the activity.
- for each item in the collection.
-
+ for each item in the collection.
+
]]>
@@ -1087,11 +1087,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The delegates to add.
Adds the specified collection as implementation variables of the activity.
- for each item in the collection.
-
+ for each item in the collection.
+
]]>
@@ -1118,11 +1118,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The activities to add.
Adds the specified collection as imported child activities of the activity.
- for each item in the collection.
-
+ for each item in the collection.
+
]]>
@@ -1149,11 +1149,11 @@ For more information, see [Imperative Code-Based Validation](/dotnet/framework/w
The delegates to add.
Adds the specified collection as imported delegates of the activity.
- for each item in the collection.
-
+ for each item in the collection.
+
]]>
diff --git a/xml/System.Activities/NativeActivity`1.xml b/xml/System.Activities/NativeActivity`1.xml
index 9ad27e34b4d..0b0c832f945 100644
--- a/xml/System.Activities/NativeActivity`1.xml
+++ b/xml/System.Activities/NativeActivity`1.xml
@@ -23,14 +23,14 @@
The result returned by the activity.
Abstract base class for custom activities that implement execution logic using the method, that has full access to the runtime's features.
- . This example is from the [How to: Create an Activity](/dotnet/framework/windows-workflow-foundation/how-to-create-an-activity) step of the [Getting Started Tutorial [.NET Framework 4.5]](/dotnet/framework/windows-workflow-foundation/getting-started-tutorial).
-
+ . This example is from the [How to: Create an Activity](/dotnet/framework/windows-workflow-foundation/how-to-create-an-activity) step of the [Getting Started Tutorial [.NET Framework 4.5]](/dotnet/framework/windows-workflow-foundation/getting-started-tutorial).
+
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/readint.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/readint.vb" id="Snippet1":::
-
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/readint.vb" id="Snippet1":::
+
]]>
@@ -90,11 +90,11 @@
Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -121,11 +121,11 @@
Not implemented.
Not implemented. Use instead.
- override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
+ override. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
]]>
@@ -152,18 +152,18 @@
The activity's metadata that encapsulates the activity's arguments, variables, child activities, and activity delegates.
Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.
- to ensure correct construction of a workflow as well as to manage run-time relationships and lifetime rules. The default implementation of examines the public members of the activity type using the type's . These public members are of type , , [IEnumerable\](xref:System.Collections.Generic.IEnumerable%601), , [IEnumerable\](xref:System.Collections.Generic.IEnumerable%601), or . You can override this method to customize the building of the activity's run-time description and to provide custom validation logic. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
-
-
-
-## Examples
- The following code sample demonstrates using CacheMetadata in a class that inherits from . This example is from the [Custom Composite using Native Activity](/dotnet/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_customcompositenativeactivity/cs/mysequence.cs" id="Snippet2":::
-
+ to ensure correct construction of a workflow as well as to manage run-time relationships and lifetime rules. The default implementation of examines the public members of the activity type using the type's . These public members are of type , , [IEnumerable\](xref:System.Collections.Generic.IEnumerable`1), , [IEnumerable\](xref:System.Collections.Generic.IEnumerable`1), or . You can override this method to customize the building of the activity's run-time description and to provide custom validation logic. Any exceptions that are thrown from are not treated as validation errors. These exceptions will escape from the call to and must be handled by the caller.
+
+
+
+## Examples
+ The following code sample demonstrates using CacheMetadata in a class that inherits from . This example is from the [Custom Composite using Native Activity](/dotnet/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_customcompositenativeactivity/cs/mysequence.cs" id="Snippet2":::
+
]]>
@@ -190,13 +190,13 @@
The execution context in which the activity executes.
When implemented in a derived class, runs logic to cause graceful early completion of the activity.
- . This example is from the [Non-Generic ParallelForEach](/dotnet/framework/windows-workflow-foundation/samples/non-generic-parallelforeach) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nongenericparallelforeach/cs/parallelforeach/parallelforeach.cs" id="Snippet2":::
-
+ . This example is from the [Non-Generic ParallelForEach](/dotnet/framework/windows-workflow-foundation/samples/non-generic-parallelforeach) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nongenericparallelforeach/cs/parallelforeach/parallelforeach.cs" id="Snippet2":::
+
]]>
@@ -221,14 +221,14 @@
if the activity can cause the workflow to become idle, otherwise . This value is by default.
- .
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_waitforinput/cs/waitforinput/waitforinput.cs" id="Snippet1":::
-
+The following code sample demonstrates using CanInduceIdle in a class that inherits from .
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_waitforinput/cs/waitforinput/waitforinput.cs" id="Snippet1":::
+
]]>
@@ -255,13 +255,13 @@ The following code sample demonstrates using CanInduceIdle in a class that inher
The execution context in which the activity executes.
When implemented in a derived class, runs the activity's execution logic.
- . This example is from the [Non-Generic ParallelForEach](/dotnet/framework/windows-workflow-foundation/samples/non-generic-parallelforeach) sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nongenericparallelforeach/cs/parallelforeach/parallelforeach.cs" id="Snippet1":::
-
+ . This example is from the [Non-Generic ParallelForEach](/dotnet/framework/windows-workflow-foundation/samples/non-generic-parallelforeach) sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_nongenericparallelforeach/cs/parallelforeach/parallelforeach.cs" id="Snippet1":::
+
]]>
diff --git a/xml/System.Activities/OutArgument`1.xml b/xml/System.Activities/OutArgument`1.xml
index dea86242f7d..954f09c16a3 100644
--- a/xml/System.Activities/OutArgument`1.xml
+++ b/xml/System.Activities/OutArgument`1.xml
@@ -34,27 +34,27 @@
The data type of the .
A binding terminal that represents the flow of data out of an activity.
- is used to flow data out of an activity. If the activity is the root activity of a workflow, then it is also used to flow data out of the workflow to the workflow host. In this example, a custom `Divide` activity that has two input arguments and one output argument is used as the root activity of a workflow. The host application passes two values into the workflow and then retrieves the result of the division after the workflow completes.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet20":::
-
- The `Divide` activity uses arguments to receive the input values and to provide the computed result values. The `Remainder` is used to pass out the remainder of the division, and the output argument provided by derived activities is used to pass out the quotient.
-
+ is used to flow data out of an activity. If the activity is the root activity of a workflow, then it is also used to flow data out of the workflow to the workflow host. In this example, a custom `Divide` activity that has two input arguments and one output argument is used as the root activity of a workflow. The host application passes two values into the workflow and then retrieves the result of the division after the workflow completes.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet20":::
+
+ The `Divide` activity uses arguments to receive the input values and to provide the computed result values. The `Remainder` is used to pass out the remainder of the division, and the output argument provided by derived activities is used to pass out the quotient.
+
> [!NOTE]
-> If your custom activity is derived from the generic with an as its generic type argument, when you invoke the activity with the Invoke method, it returns an value. In Addition, the method will return an value instead of `void` and you do not need to set a return value.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet120":::
-
-
-
-## Examples
- The following code sample demonstrates creating an . This example is from the Formatter sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_formatter/cs/program.cs" id="Snippet1":::
-
+> If your custom activity is derived from the generic with an as its generic type argument, when you invoke the activity with the Invoke method, it returns an value. In Addition, the method will return an value instead of `void` and you do not need to set a return value.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet120":::
+
+
+
+## Examples
+ The following code sample demonstrates creating an . This example is from the Formatter sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_formatter/cs/program.cs" id="Snippet1":::
+
]]>
@@ -83,13 +83,13 @@
Initialize a new instance of the class using default values.
- . This example is from the Formatter sample.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_formatter/cs/program.cs" id="Snippet1":::
-
+ . This example is from the Formatter sample.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/wfs_formatter/cs/program.cs" id="Snippet1":::
+
]]>
@@ -398,11 +398,11 @@
Initializes and returns a new constructed using the specified .
The new argument.
-
diff --git a/xml/System.Activities/OverloadGroupAttribute.xml b/xml/System.Activities/OverloadGroupAttribute.xml
index aa611072865..33e67e484a3 100644
--- a/xml/System.Activities/OverloadGroupAttribute.xml
+++ b/xml/System.Activities/OverloadGroupAttribute.xml
@@ -22,17 +22,17 @@
Provides a method for indicating which combinations of arguments are valid in an activity.
- is `false`. Overload groups can overlap but it is an error if the intersection of the groups contains all the required arguments of one or both the overload groups.
-
- An overload group is considered bound if all the arguments in the group are bound. If a group has zero arguments and at least one argument bound, then the group is considered bound. It is an error if none of the groups are bound unless one overload group has no arguments in it. Binding arguments from more than one overload group is not permitted. It is an error to have more than one overload group bound, that is, all required arguments in one overload group are bound and any argument in another overload group is also bound.
-
- Any violation of the preceding rules results in a being thrown when the containing activity is prepared for execution.
-
- The is set to `true` if the is applied to an argument.
-
+ is `false`. Overload groups can overlap but it is an error if the intersection of the groups contains all the required arguments of one or both the overload groups.
+
+ An overload group is considered bound if all the arguments in the group are bound. If a group has zero arguments and at least one argument bound, then the group is considered bound. It is an error if none of the groups are bound unless one overload group has no arguments in it. Binding arguments from more than one overload group is not permitted. It is an error to have more than one overload group bound, that is, all required arguments in one overload group are bound and any argument in another overload group is also bound.
+
+ Any violation of the preceding rules results in a being thrown when the containing activity is prepared for execution.
+
+ The is set to `true` if the is applied to an argument.
+
]]>
diff --git a/xml/System.Activities/PersistableIdleAction.xml b/xml/System.Activities/PersistableIdleAction.xml
index 3125c5c1b71..bc2d222856c 100644
--- a/xml/System.Activities/PersistableIdleAction.xml
+++ b/xml/System.Activities/PersistableIdleAction.xml
@@ -15,11 +15,11 @@
Specifies the action that occurs when a workflow becomes idle when persistence is allowed.
- function is invoked when the scheduler has no more pending work items and the workflow runtime can persist. Note that the function is invoked when persistence is not allowed, and both and are invoked in that order when persistence is allowed. None is the default action if no handler is provided.
-
+ function is invoked when the scheduler has no more pending work items and the workflow runtime can persist. Note that the function is invoked when persistence is not allowed, and both and are invoked in that order when persistence is allowed. None is the default action if no handler is provided.
+
]]>
diff --git a/xml/System.Activities/RuntimeArgument.xml b/xml/System.Activities/RuntimeArgument.xml
index 5dbb0b9bcd5..84e88633a5a 100644
--- a/xml/System.Activities/RuntimeArgument.xml
+++ b/xml/System.Activities/RuntimeArgument.xml
@@ -153,15 +153,15 @@
The names of the overload groups that apply to this .
Initializes a new instance of the class with a name, data type, argument direction, whether the is required to be bound to a value, and a list of overload group names.
- is set to `true` if the is applied to an argument.
-
- Overload groups can be set on arguments through the .
-
+ is set to `true` if the is applied to an argument.
+
+ Overload groups can be set on arguments through the .
+
]]>
@@ -298,11 +298,11 @@
if the is required to be bound to a value; otherwise, .
- is thrown when the containing activity is prepared for execution, unless overload groups are used and the required arguments of an overload group are bound. For more information, see .
-
+ is thrown when the containing activity is prepared for execution, unless overload groups are used and the required arguments of an overload group are bound. For more information, see .
+
]]>
@@ -353,17 +353,17 @@
Gets a list of the overload groups that this belongs to.
A list of overload group names.
- identifies the overload groups to which this argument belongs. An overload group cannot be a subset or an equivalent set of another overload group. The only exception to this rule is a subset that contains only arguments where is `false`. Overload groups can overlap but it is an error if the intersection of the groups contains all the required arguments of one or both the overload groups.
-
- An overload group is considered bound if all the arguments in the group are bound. If a group has zero arguments and at least one argument bound, then the group is considered bound. It is an error if none of the groups are bound unless one overload group has no arguments in it. Binding arguments from more than one overload group is not permitted. It is an error to have more than one overload group bound, that is, all required arguments in one overload group are bound and any argument in another overload group is also bound.
-
- Any violation of the preceding rules results in a being thrown when the containing activity is prepared for execution.
-
- For more information, see .
-
+ identifies the overload groups to which this argument belongs. An overload group cannot be a subset or an equivalent set of another overload group. The only exception to this rule is a subset that contains only arguments where is `false`. Overload groups can overlap but it is an error if the intersection of the groups contains all the required arguments of one or both the overload groups.
+
+ An overload group is considered bound if all the arguments in the group are bound. If a group has zero arguments and at least one argument bound, then the group is considered bound. It is an error if none of the groups are bound unless one overload group has no arguments in it. Binding arguments from more than one overload group is not permitted. It is an error to have more than one overload group bound, that is, all required arguments in one overload group are bound and any argument in another overload group is also bound.
+
+ Any violation of the preceding rules results in a being thrown when the containing activity is prepared for execution.
+
+ For more information, see .
+
]]>
diff --git a/xml/System.Activities/RuntimeTransactionHandle.xml b/xml/System.Activities/RuntimeTransactionHandle.xml
index 83b64d05599..9c9fa218bb4 100644
--- a/xml/System.Activities/RuntimeTransactionHandle.xml
+++ b/xml/System.Activities/RuntimeTransactionHandle.xml
@@ -104,11 +104,11 @@
if the workflow instance should be aborted if the transaction fails; otherwise, .
- is `false`, transaction failure results in the exception that causes the failure to be propagated as normal. The default value for is `true`.
-
+ is `false`, transaction failure results in the exception that causes the failure to be propagated as normal. The default value for is `true`.
+
]]>
@@ -360,11 +360,11 @@
An optional user-provided state that contains information about the request.
Initiates the creation of a for use with a new transaction.
-
@@ -401,11 +401,11 @@
An optional user-provided state that contains information about the request.
Initiates the creation of a for use with an existing transaction.
- and the subsequent callback. Calling again before the first call completes is not allowed and all calls after the first call result in exceptions. This method allows transactions flowed in from the host to be provided to the runtime without risking an intermediate persistence point. The state object that can be serialized is not necessary because the instance is guaranteed not to persist when this method is used.
-
+ and the subsequent callback. Calling again before the first call completes is not allowed and all calls after the first call result in exceptions. This method allows transactions flowed in from the host to be provided to the runtime without risking an intermediate persistence point. The state object that can be serialized is not necessary because the instance is guaranteed not to persist when this method is used.
+
]]>
diff --git a/xml/System.Activities/UnhandledExceptionAction.xml b/xml/System.Activities/UnhandledExceptionAction.xml
index c8dc7d42aa2..02b36c703b6 100644
--- a/xml/System.Activities/UnhandledExceptionAction.xml
+++ b/xml/System.Activities/UnhandledExceptionAction.xml
@@ -15,26 +15,26 @@
Specifies the action that occurs when an exception escapes the root of a workflow.
- function is invoked if an exception escapes the root of the workflow. The provides access to the exception as well as a pointer to the that generated the exception. Terminate is the default action if no handler is specified.
-
-
-
+ function is invoked if an exception escapes the root of the workflow. The provides access to the exception as well as a pointer to the that generated the exception. Terminate is the default action if no handler is specified.
+
+
+
## Examples
-The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
-
-:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet6":::
+The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
+
+:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet6":::
+
+The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is aborted.
+
+:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet7":::
-The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is aborted.
-
-:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet7":::
+The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is cancelled.
-The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is cancelled.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet8":::
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet8":::
]]>
diff --git a/xml/System.Activities/Variable`1.xml b/xml/System.Activities/Variable`1.xml
index 4a5681d5e38..d3565a05844 100644
--- a/xml/System.Activities/Variable`1.xml
+++ b/xml/System.Activities/Variable`1.xml
@@ -20,31 +20,31 @@
The of the .
Represents a variable in a workflow.
- is used to hold a message string. This message is written to the console window by a activity.
-
-```csharp
-Variable msg =
- new Variable() { Default = "Hello World!" };
-
-Activity wf = new Sequence()
-{
- Variables =
- {
- msg
- },
- Activities =
- {
- new WriteLine()
- {
- Text = msg
- }
- }
-};
-```
-
+ is used to hold a message string. This message is written to the console window by a activity.
+
+```csharp
+Variable msg =
+ new Variable() { Default = "Hello World!" };
+
+Activity wf = new Sequence()
+{
+ Variables =
+ {
+ msg
+ },
+ Activities =
+ {
+ new WriteLine()
+ {
+ Text = msg
+ }
+ }
+};
+```
+
]]>
@@ -192,11 +192,11 @@ Activity wf = new Sequence()
Gets or sets the that represents the default value for this .
The default value for this .
- is thrown.
-
+ is thrown.
+
]]>
diff --git a/xml/System.Activities/WorkflowApplication.xml b/xml/System.Activities/WorkflowApplication.xml
index a232e48fd0c..1b5502e7213 100644
--- a/xml/System.Activities/WorkflowApplication.xml
+++ b/xml/System.Activities/WorkflowApplication.xml
@@ -16,41 +16,41 @@
Provides a host for a single instance of a workflow.
- class provides a host for a single workflow instance. It is a proxy to the actual workflow instance that is managed by the workflow runtime. Users of can instruct the workflow runtime to perform actions on a workflow instance by calling the appropriate methods on a object. If a requested action is not valid, an exception is thrown.
-
- Using you can perform the following tasks:
-
-1. Create a new workflow instance, or load a workflow instance from an instance store.
-
-2. Provide extensions to be used by activities within a workflow instance.
-
-3. Control the execution of a workflow instance.
-
-4. Resume a bookmark created by an activity within a workflow instance.
-
-5. Persist or unload a workflow instance.
-
-6. Be notified of workflow instance lifecycle events.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . When the workflow is completed, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Idle.
-Ending the workflow.
-Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Completed
-Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Unloaded.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet9":::
-
+ class provides a host for a single workflow instance. It is a proxy to the actual workflow instance that is managed by the workflow runtime. Users of can instruct the workflow runtime to perform actions on a workflow instance by calling the appropriate methods on a object. If a requested action is not valid, an exception is thrown.
+
+ Using you can perform the following tasks:
+
+1. Create a new workflow instance, or load a workflow instance from an instance store.
+
+2. Provide extensions to be used by activities within a workflow instance.
+
+3. Control the execution of a workflow instance.
+
+4. Resume a bookmark created by an activity within a workflow instance.
+
+5. Persist or unload a workflow instance.
+
+6. Be notified of workflow instance lifecycle events.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . When the workflow is completed, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Idle.
+Ending the workflow.
+Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Completed
+Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Unloaded.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet9":::
+
]]>
@@ -83,21 +83,21 @@ Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Unloaded.
The workflow definition.
Creates a new instance of the class with the specified workflow definition.
- . A instance is constructed using a workflow definition consisting of a single `DiceRoll` activity. The `DiceRoll` activity has two output arguments that represent the results of the dice roll operation. When the workflow completes, the outputs are retrieved in the handler, and the following output is displayed to the console.
-
-```Output
-Workflow aae3fb48-7229-4737-b969-d63e131b96b3 Completed.
-The two dice are 1 and 5.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet130":::
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet21":::
-
+ . A instance is constructed using a workflow definition consisting of a single `DiceRoll` activity. The `DiceRoll` activity has two output arguments that represent the results of the dice roll operation. When the workflow completes, the outputs are retrieved in the handler, and the following output is displayed to the console.
+
+```Output
+Workflow aae3fb48-7229-4737-b969-d63e131b96b3 Completed.
+The two dice are 1 and 5.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet130":::
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet21":::
+
]]>
@@ -146,22 +146,22 @@ The two dice are 1 and 5.
The values for arguments defined on the root activity of the workflow definition, keyed by argument name.
Creates a new instance of the class that uses the specified workflow definition and argument values.
- . A instance is constructed using a workflow definition consisting of a single `Divide` activity that takes two input arguments, and a dictionary of input arguments containing the two values to be passed, keyed by argument name. The desired workflow lifecycle events are handled, and the workflow is invoked with a call to . When the workflow is completed, the following output is displayed to the console.
-
-```Output
-Workflow 8dc844c1-bbf8-4b21-a9a2-05f89e416055 Completed
-500 / 36 = 13 Remainder 32
-Workflow 8dc844c1-bbf8-4b21-a9a2-05f89e416055 Unloaded.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet120":::
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet10":::
-
+ . A instance is constructed using a workflow definition consisting of a single `Divide` activity that takes two input arguments, and a dictionary of input arguments containing the two values to be passed, keyed by argument name. The desired workflow lifecycle events are handled, and the workflow is invoked with a call to . When the workflow is completed, the following output is displayed to the console.
+
+```Output
+Workflow 8dc844c1-bbf8-4b21-a9a2-05f89e416055 Completed
+500 / 36 = 13 Remainder 32
+Workflow 8dc844c1-bbf8-4b21-a9a2-05f89e416055 Unloaded.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet120":::
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet10":::
+
]]>
@@ -199,11 +199,11 @@ Workflow 8dc844c1-bbf8-4b21-a9a2-05f89e416055 Unloaded.
Notifies the workflow runtime that this workflow instance should abort.
- is aborted, the handler is invoked and the handler is not invoked.
-
+ is aborted, the handler is invoked and the handler is not invoked.
+
]]>
@@ -227,27 +227,27 @@ Workflow 8dc844c1-bbf8-4b21-a9a2-05f89e416055 Unloaded.
Notifies the workflow runtime that this workflow instance should abort.
- is aborted, the handler is invoked and the handler is not invoked.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is aborted, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow 3b76d562-516a-4a52-b17c-0f2ce531ad93 Idle.
-Workflow 3b76d562-516a-4a52-b17c-0f2ce531ad93 Aborted
-Exception: System.Activities.WorkflowApplicationAbortedException
-The workflow has been aborted.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet11":::
-
+ is aborted, the handler is invoked and the handler is not invoked.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is aborted, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow 3b76d562-516a-4a52-b17c-0f2ce531ad93 Idle.
+Workflow 3b76d562-516a-4a52-b17c-0f2ce531ad93 Aborted
+Exception: System.Activities.WorkflowApplicationAbortedException
+The workflow has been aborted.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet11":::
+
]]>
@@ -274,27 +274,27 @@ The workflow has been aborted.
The reason for the request to abort.
Notifies the workflow runtime that this workflow instance should abort for the specified reason.
- is aborted, the handler is invoked and the handler is not invoked.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is aborted, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow 607b042e-98db-4bbe-abe8-f4d750feec41 Idle.
-Workflow 607b042e-98db-4bbe-abe8-f4d750feec41 Aborted
-Exception: System.Activities.WorkflowApplicationAbortedException
-The reason for aborting the workflow.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet11":::
-
+ is aborted, the handler is invoked and the handler is not invoked.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is aborted, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow 607b042e-98db-4bbe-abe8-f4d750feec41 Idle.
+Workflow 607b042e-98db-4bbe-abe8-f4d750feec41 Aborted
+Exception: System.Activities.WorkflowApplicationAbortedException
+The reason for aborting the workflow.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet11":::
+
]]>
@@ -324,18 +324,18 @@ The reason for aborting the workflow.
Gets or sets the that is invoked when the workflow instance is aborted.
The action that is invoked when the workflow instance is aborted.
- is aborted, the handler is invoked and the handler is not invoked.
-
-
-
-## Examples
- The following code example inspects the passed into the handler of a instance and displays information about why workflow was aborted.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet5":::
-
+ is aborted, the handler is invoked and the handler is not invoked.
+
+
+
+## Examples
+ The following code example inspects the passed into the handler of a instance and displays information about why workflow was aborted.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet5":::
+
]]>
@@ -372,11 +372,11 @@ The reason for aborting the workflow.
Cancels a workflow asynchronously using the asynchronous design pattern.
-
@@ -406,13 +406,13 @@ The reason for aborting the workflow.
Cancels a workflow instance asynchronously using the specified and user-provided state.
A reference to the asynchronous cancel operation.
- . can be called from inside or outside of the `callback` method. If is called before the cancel operation completes, it blocks until the cancel operation completes. By default, the cancel operation must complete in 30 seconds or a is thrown from .
-
- This method cancels a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ . can be called from inside or outside of the `callback` method. If is called before the cancel operation completes, it blocks until the cancel operation completes. By default, the cancel operation must complete in 30 seconds or a is thrown from .
+
+ This method cancels a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -444,13 +444,13 @@ The reason for aborting the workflow.
Cancels a workflow instance asynchronously using the specified time-out interval, , and user-provided state.
A reference to the asynchronous cancel operation.
- . can be called from inside or outside of the method specified in the `callback` parameter. If is called before the cancel operation completes, it blocks until the cancel operation completes. If the cancel operation does not complete in the interval specified by the `timeOut` parameter, a is thrown from .
-
- This method cancels a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ . can be called from inside or outside of the method specified in the `callback` parameter. If is called before the cancel operation completes, it blocks until the cancel operation completes. If the cancel operation does not complete in the interval specified by the `timeOut` parameter, a is thrown from .
+
+ This method cancels a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -751,11 +751,11 @@ The reason for aborting the workflow.
Loads a workflow asynchronously from an instance store using the asynchronous design pattern.
-
@@ -952,11 +952,11 @@ The reason for aborting the workflow.
Initiates the asynchronous process of loading a runnable workflow instance from the .
-
@@ -986,15 +986,15 @@ The reason for aborting the workflow.
Initiates an operation to load a runnable workflow instance from the .
A reference to the asynchronous operation.
- . can be called from inside or outside of the `callback` method. If is called before the resume operation completes, it blocks until the resume operation completes. By default, the resume operation must complete in 30 seconds or else a is thrown from .
-
- This method loads a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ . can be called from inside or outside of the `callback` method. If is called before the resume operation completes, it blocks until the resume operation completes. By default, the resume operation must complete in 30 seconds or else a is thrown from .
+
+ This method loads a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1026,15 +1026,15 @@ The reason for aborting the workflow.
Initiates an operation to load a runnable workflow instance from the using the specified time-out interval.
A reference to the asynchronous operation.
- . can be called from inside or outside of the `callback` method. If is called before the resume operation completes, it blocks until the resume operation completes. If the load operation does not complete within the specified time-out interval a is thrown from .
-
- This method loads a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ . can be called from inside or outside of the `callback` method. If is called before the resume operation completes, it blocks until the resume operation completes. If the load operation does not complete within the specified time-out interval a is thrown from .
+
+ This method loads a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1047,13 +1047,13 @@ The reason for aborting the workflow.
Persists a workflow instance to an instance store asynchronously using the asynchronous design pattern.
- used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
-
+ used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+
]]>
@@ -1083,15 +1083,15 @@ The reason for aborting the workflow.
Persists a workflow instance to an instance store asynchronously using the specified callback method and user-provided state.
A reference to the asynchronous persist operation.
- . can be called from inside or outside of the method referenced in the `callback` parameter. If is called before the persist operation completes, it blocks until the persist operation completes. If the persist operation does not complete within 30 seconds, a is thrown from .
-
- If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
-
- This method persists a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ . can be called from inside or outside of the method referenced in the `callback` parameter. If is called before the persist operation completes, it blocks until the persist operation completes. If the persist operation does not complete within 30 seconds, a is thrown from .
+
+ If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+
+ This method persists a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1123,15 +1123,15 @@ The reason for aborting the workflow.
Persists a workflow instance to an instance store asynchronously using the specified time-out interval, callback method, and user-provided state.
A reference to the asynchronous persist operation.
- . can be called from inside or outside of the method referenced in the `callback` parameter. If is called before the persist operation completes, it blocks until the persist operation completes. If the persist operation does not complete within the specified time-out interval, a is thrown from .
-
- If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
-
- This method persists a workflow instance asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ . can be called from inside or outside of the method referenced in the `callback` parameter. If is called before the persist operation completes, it blocks until the persist operation completes. If the persist operation does not complete within the specified time-out interval, a is thrown from .
+
+ If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+
+ This method persists a workflow instance asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1174,13 +1174,13 @@ The reason for aborting the workflow.
Initiates an operation to resume a bookmark using the specified value, callback method, and state.
A reference to the asynchronous bookmark resume operation.
- . can be called from inside or outside of the `callback` method. If is called before the resume operation completes, it blocks until the resume operation completes. By default, the resume operation must complete in 30 seconds or else a is thrown from .
-
- This method resumes a bookmark asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ . can be called from inside or outside of the `callback` method. If is called before the resume operation completes, it blocks until the resume operation completes. By default, the resume operation must complete in 30 seconds or else a is thrown from .
+
+ This method resumes a bookmark asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1214,11 +1214,11 @@ The reason for aborting the workflow.
Initiates an asynchronous operation to resume the bookmark with the specified name, using the specified value, callback method, and state. The bookmark to be resumed is previously created by an activity within the workflow instance.
The result of the bookmark resumption operation.
-
@@ -1254,13 +1254,13 @@ The reason for aborting the workflow.
Initiates an operation to resume a bookmark using the specified value, time-out interval, callback method, and state.
A reference to the asynchronous bookmark resume operation.
- . can be called from inside or outside of the `callback` method. If is called before the resume operation completes, it blocks until the resume operation completes. If the resume operation does not complete within the specified time-out interval a is thrown from .
-
- This method resumes a bookmark asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ . can be called from inside or outside of the `callback` method. If is called before the resume operation completes, it blocks until the resume operation completes. If the resume operation does not complete within the specified time-out interval a is thrown from .
+
+ This method resumes a bookmark asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1296,11 +1296,11 @@ The reason for aborting the workflow.
Initiates an asynchronous operation to resume the bookmark with the specified name, using the specified value, time-out interval, callback method, and state. The bookmark to be resumed is previously created by an activity within the workflow instance.
The result of the bookmark resumption operation.
-
@@ -1313,11 +1313,11 @@ The reason for aborting the workflow.
Starts or resumes a workflow instance asynchronously using the asynchronous design pattern.
-
@@ -1347,13 +1347,13 @@ The reason for aborting the workflow.
Starts or resumes a workflow instance asynchronously using the specified callback method and user-provided state.
A reference to the asynchronous run operation.
- . can be called from inside or outside of the method referenced in the `callback` parameter. If is called before the resume operation completes, it blocks until the resume operation completes. By default, the resume operation must complete in 30 seconds or a is thrown from .
-
- This method starts or resumes a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ . can be called from inside or outside of the method referenced in the `callback` parameter. If is called before the resume operation completes, it blocks until the resume operation completes. By default, the resume operation must complete in 30 seconds or a is thrown from .
+
+ This method starts or resumes a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1391,13 +1391,13 @@ The reason for aborting the workflow.
Starts or resumes a workflow instance asynchronously using the specified time-out interval, callback method, and user-provided state.
A reference to the asynchronous run operation.
- . can be called from inside or outside of the method reference in the `callback` parameter. If is called before the resume operation completes, it blocks until the resume operation completes. If the resume operation does not complete within the specified time-out interval a is thrown from .
-
- This method starts or resumes a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ . can be called from inside or outside of the method reference in the `callback` parameter. If is called before the resume operation completes, it blocks until the resume operation completes. If the resume operation does not complete within the specified time-out interval a is thrown from .
+
+ This method starts or resumes a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1410,11 +1410,11 @@ The reason for aborting the workflow.
Terminates a workflow instance asynchronously using the asynchronous design pattern.
-
@@ -1446,15 +1446,15 @@ The reason for aborting the workflow.
Terminates a workflow instance asynchronously using the specified exception, callback method, and user-provided state.
A reference to the current operation.
- handle.
-
- To determine whether the operation was successful, call . can be called from inside or outside of the method referenced in the `callback` parameter. If is called before the operation completes, it blocks until the operation completes. By default, the operation must complete in 30 seconds or a is thrown from .
-
- This method terminates a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ handle.
+
+ To determine whether the operation was successful, call . can be called from inside or outside of the method referenced in the `callback` parameter. If is called before the operation completes, it blocks until the operation completes. By default, the operation must complete in 30 seconds or a is thrown from .
+
+ This method terminates a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1486,15 +1486,15 @@ The reason for aborting the workflow.
Terminates a workflow instance asynchronously using the specified error message, callback method, and user-provided state.
A reference to the current operation.
- handle.
-
- To determine whether the operation was successful, call . can be called from inside or outside of the method reference in the `callback` parameter. If is called before the operation completes, it blocks until the operation completes. By default, the operation must complete in 30 seconds or a is thrown from .
-
- This method terminates a workflow instance asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ handle.
+
+ To determine whether the operation was successful, call . can be called from inside or outside of the method reference in the `callback` parameter. If is called before the operation completes, it blocks until the operation completes. By default, the operation must complete in 30 seconds or a is thrown from .
+
+ This method terminates a workflow instance asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1528,15 +1528,15 @@ The reason for aborting the workflow.
Terminates a workflow instance asynchronously using the specified exception, time-out interval, callback method, and user-provided state.
A reference to the current operation.
- handle.
-
- To determine whether the operation was successful, call . can be called from inside or outside of the `callback` method. If is called before the operation completes, it blocks until the operation completes. If the operation does not complete within the specified time-out interval a is thrown. This or any other exceptions that occur during the process is thrown from .
-
- This method terminates a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ handle.
+
+ To determine whether the operation was successful, call . can be called from inside or outside of the `callback` method. If is called before the operation completes, it blocks until the operation completes. If the operation does not complete within the specified time-out interval a is thrown. This or any other exceptions that occur during the process is thrown from .
+
+ This method terminates a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1570,15 +1570,15 @@ The reason for aborting the workflow.
Terminates a workflow instance asynchronously using the specified error message, time-out interval, callback method, and user-provided state.
A reference to the asynchronous operation.
- handle.
-
- To determine whether the operation was successful, call . can be called from inside or outside of the method reference in the `callback` parameter. If is called before the operation completes, it blocks until the operation completes. If the operation does not complete within the specified time-out interval a is thrown from .
-
- This method terminates a workflow instance asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ handle.
+
+ To determine whether the operation was successful, call . can be called from inside or outside of the method reference in the `callback` parameter. If is called before the operation completes, it blocks until the operation completes. If the operation does not complete within the specified time-out interval a is thrown from .
+
+ This method terminates a workflow instance asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1591,13 +1591,13 @@ The reason for aborting the workflow.
Persists and disposes a workflow instance asynchronously using the asynchronous design pattern.
- used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
-
+ used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+
]]>
@@ -1627,15 +1627,15 @@ The reason for aborting the workflow.
Persists and disposes a workflow instance asynchronously using the specified callback method and user-provided state.
A reference to the asynchronous operation.
- operation was successful, call . can be called from inside or outside of the method reference in the `callback` parameter. If is called before the operation completes, it blocks until the operation completes. By default, the operation must complete in 30 seconds or a is thrown from .
-
- If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
-
- This method persists and disposes a workflow instance asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ operation was successful, call . can be called from inside or outside of the method reference in the `callback` parameter. If is called before the operation completes, it blocks until the operation completes. By default, the operation must complete in 30 seconds or a is thrown from .
+
+ If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+
+ This method persists and disposes a workflow instance asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1667,15 +1667,15 @@ The reason for aborting the workflow.
Persists and disposes a workflow instance asynchronously using the specified time-out interval, callback method, and user-provided state.
A reference to the asynchronous operation.
- operation was successful, call . can be called from inside or outside of the method reference in the `callback` parameter. If is called before the operation completes, it blocks until the operation completes. If the operation does not complete within the specified time-out interval a is thrown from .
-
- If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
-
- This method persists and unloads a workflow instance asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ operation was successful, call . can be called from inside or outside of the method reference in the `callback` parameter. If is called before the operation completes, it blocks until the operation completes. If the operation does not complete within the specified time-out interval a is thrown from .
+
+ If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+
+ This method persists and unloads a workflow instance asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -1688,13 +1688,13 @@ The reason for aborting the workflow.
Cancels the workflow instance.
- handle.
-
- By default, the cancel operation must complete in 30 seconds or a is thrown.
-
+ handle.
+
+ By default, the cancel operation must complete in 30 seconds or a is thrown.
+
]]>
@@ -1718,28 +1718,28 @@ The reason for aborting the workflow.
Cancels the workflow instance.
- handler.
-
- By default, the cancel operation must complete in 30 seconds or a is thrown.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is cancelled, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Idle.
-Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Canceled
-Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet13":::
-
+ handler.
+
+ By default, the cancel operation must complete in 30 seconds or a is thrown.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is cancelled, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Idle.
+Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Canceled
+Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet13":::
+
]]>
@@ -1766,26 +1766,26 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
The interval in which the cancel operation must complete before the operation is canceled and a is thrown.
Cancels the workflow instance using the specified time-out interval.
- handler.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is cancelled, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Idle.
-Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Canceled
-Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet13":::
-
+ handler.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is cancelled, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Idle.
+Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Canceled
+Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet13":::
+
]]>
@@ -1815,13 +1815,13 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
Gets or sets the that is invoked when the workflow instance completes.
The action that is invoked when the workflow instance is complete.
- passed into the handler of a instance and displays information about how the workflow completed.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet4":::
-
+ passed into the handler of a instance and displays information about how the workflow completed.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet4":::
+
]]>
@@ -1974,13 +1974,13 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
The asynchronous cancel operation.
Waits for the pending asynchronous cancel operation to complete.
- operation was successful. If called before the cancel operation completes, it blocks until the cancel operation is complete.
-
- This method completes the asynchronous cancel operation using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ operation was successful. If called before the cancel operation completes, it blocks until the cancel operation is complete.
+
+ This method completes the asynchronous cancel operation using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -2105,13 +2105,13 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
The asynchronous load operation.
Waits for the pending asynchronous load operation to complete.
- asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -2138,13 +2138,13 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
A reference to the asynchronous load operation.
Waits for the asynchronous load runnable instance operation to complete.
- operation was successful. If called before the load operation completes, it blocks until the operation is complete.
-
- This method loads workflows asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ operation was successful. If called before the load operation completes, it blocks until the operation is complete.
+
+ This method loads workflows asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -2171,13 +2171,13 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
The asynchronous persist operation.
Waits for the pending asynchronous persist operation to complete.
- operation was successful. If called before the persist operation completes, it blocks until the persist operation is complete.
-
- This method completes the asynchronous persist operation using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ operation was successful. If called before the persist operation completes, it blocks until the persist operation is complete.
+
+ This method completes the asynchronous persist operation using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -2205,13 +2205,13 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
Waits for a bookmark resume operation to complete.
One of the enumeration values that indicates the results of a bookmark resumption operation.
- operation was successful. If called before the load operation completes, it blocks until the operation is complete.
-
- This method resumes a bookmark asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ operation was successful. If called before the load operation completes, it blocks until the operation is complete.
+
+ This method resumes a bookmark asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -2238,13 +2238,13 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
The asynchronous run operation.
Waits for the pending asynchronous run operation to complete.
- operation was successful. If called before the resume operation completes, it blocks until the resume operation is complete.
-
- This method completes an asynchronous run operation using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ operation was successful. If called before the resume operation completes, it blocks until the resume operation is complete.
+
+ This method completes an asynchronous run operation using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -2271,13 +2271,13 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
The asynchronous terminate operation.
Waits for the pending asynchronous terminate operation to complete.
- operation was successful. If called before the terminate operation completes, it blocks until the operation is complete.
-
- This method completes an asynchronous operation using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ operation was successful. If called before the terminate operation completes, it blocks until the operation is complete.
+
+ This method completes an asynchronous operation using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -2304,13 +2304,13 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
The asynchronous unload operation.
Waits for the pending asynchronous unload operation to complete.
- operation was successful. If called before the unload operation completes, it blocks until the operation is complete.
-
- This method completes an asynchronous operation using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
-
+ operation was successful. If called before the unload operation completes, it blocks until the operation is complete.
+
+ This method completes an asynchronous operation using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
+
]]>
@@ -2365,28 +2365,28 @@ Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.
Returns the collection of bookmarks for the workflow instance.
A read-only collection of bookmarks for the workflow instance.
- is thrown.
-
-
-
-## Examples
- The following example creates a workflow that uses a `ReadLine` activity that creates a . The workflow is started, and once the is created and the workflow goes idle, is called. When the workflow is completed, the following output is displayed to the console.
-
-```Output
-What is your name?
-BookmarkName: UserName - OwnerDisplayName: ReadLine
-Steve
-Hello, Steve
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet14":::
-
+ is thrown.
+
+
+
+## Examples
+ The following example creates a workflow that uses a `ReadLine` activity that creates a . The workflow is started, and once the is created and the workflow goes idle, is called. When the workflow is completed, the following output is displayed to the console.
+
+```Output
+What is your name?
+BookmarkName: UserName - OwnerDisplayName: ReadLine
+Steve
+Hello, Steve
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet14":::
+
]]>
@@ -2414,23 +2414,23 @@ Hello, Steve
Returns the collection of bookmarks for the workflow instance using the specified time-out interval.
A read-only collection of bookmarks for the workflow instance.
- . The workflow is started, and once the is created and the workflow goes idle, is called. When the workflow is completed, the following output is displayed to the console.
-
-```Output
-What is your name?
-BookmarkName: UserName - OwnerDisplayName: ReadLine
-Steve
-Hello, Steve
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet14":::
-
+ . The workflow is started, and once the is created and the workflow goes idle, is called. When the workflow is completed, the following output is displayed to the console.
+
+```Output
+What is your name?
+BookmarkName: UserName - OwnerDisplayName: ReadLine
+Steve
+Hello, Steve
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet14":::
+
]]>
@@ -2580,13 +2580,13 @@ Hello, Steve
Gets the 128-bit GUID identifier of the current workflow application instance.
A 128-bit GUID identifier.
- instance and then displays the value to the console.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet28":::
-
+ instance and then displays the value to the console.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet28":::
+
]]>
@@ -2616,17 +2616,17 @@ Hello, Steve
Gets or sets the that is invoked when the current workflow instance becomes idle.
An action that executes when a workflow instance becomes idle.
- passed into the handler of a instance. In this example the workflow going idle has one with a name of `EnterGuess`, owned by an activity named `ReadInt`. This code example is based off of [How to: Run a Workflow](/dotnet/framework/windows-workflow-foundation/how-to-run-a-workflow), which is part of the [Getting Started Tutorial [.NET Framework 4.5]](/dotnet/framework/windows-workflow-foundation/getting-started-tutorial). If the handler in that step is modified to contain the code from this example, the following output is displayed.
-
-```Output
-BookmarkName: EnterGuess - OwnerDisplayName: ReadInt
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet2":::
-
+ passed into the handler of a instance. In this example the workflow going idle has one with a name of `EnterGuess`, owned by an activity named `ReadInt`. This code example is based off of [How to: Run a Workflow](/dotnet/framework/windows-workflow-foundation/how-to-run-a-workflow), which is part of the [Getting Started Tutorial [.NET Framework 4.5]](/dotnet/framework/windows-workflow-foundation/getting-started-tutorial). If the handler in that step is modified to contain the code from this example, the following output is displayed.
+
+```Output
+BookmarkName: EnterGuess - OwnerDisplayName: ReadInt
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet2":::
+
]]>
@@ -2656,13 +2656,13 @@ BookmarkName: EnterGuess - OwnerDisplayName: ReadInt
Gets or sets an object that provides access to the persisted state of the current instance of the workflow application.
An instance store.
- using a . This code example is part of [How to: Create and Run a Long Running Workflow](/dotnet/framework/windows-workflow-foundation/how-to-create-and-run-a-long-running-workflow), which is part of the [Getting Started Tutorial [.NET Framework 4.5]](/dotnet/framework/windows-workflow-foundation/getting-started-tutorial).
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet28":::
-
+ using a . This code example is part of [How to: Create and Run a Long Running Workflow](/dotnet/framework/windows-workflow-foundation/how-to-create-and-run-a-long-running-workflow), which is part of the [Getting Started Tutorial [.NET Framework 4.5]](/dotnet/framework/windows-workflow-foundation/getting-started-tutorial).
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet28":::
+
]]>
@@ -2722,14 +2722,14 @@ BookmarkName: EnterGuess - OwnerDisplayName: ReadInt
A globally unique 128-bit identifier for the workflow instance.
Loads the specified workflow instance into memory from an instance store.
- to load persisted workflow instance from a .
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet27":::
-
+The following example calls to load persisted workflow instance from a .
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet27":::
+
]]>
@@ -2810,14 +2810,14 @@ The following example calls
The interval in which the load operation must complete before the load operation is canceled and a is thrown.
Loads the specified workflow instance into memory from an instance store using the specified time-out interval.
- to load persisted workflow instance from a .
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet27":::
-
+The following example calls to load persisted workflow instance from a .
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet27":::
+
]]>
@@ -2858,11 +2858,11 @@ The following example calls
Loads a runnable workflow instance from the .
-
@@ -2886,13 +2886,13 @@ The following example calls
Loads a runnable workflow instance from the .
- is thrown.
-
+ is thrown.
+
]]>
@@ -2919,11 +2919,11 @@ The following example calls
The interval in which the load operation must complete before the operation is canceled and a is thrown.
Loads a runnable workflow instance from the using the specified time-out interval.
-
@@ -3224,18 +3224,18 @@ The following example calls
Gets or sets the that is invoked when the current workflow instance encounters an unhandled exception.
The delegate that is invoked when a workflow instance encounters an unhandled exception.
- and dictate the behavior of the runtime when an exception is not handled in the workflow; however, has the option of leaving a suspended workflow in the persistence store, while does not. The reason for this is that what happens to a suspended workflow is host-specific, and is not. To implement this functionality using , create a custom that has this behavior.
-
-
-
-## Examples
- The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet1":::
-
+ and dictate the behavior of the runtime when an exception is not handled in the workflow; however, has the option of leaving a suspended workflow in the persistence store, while does not. The reason for this is that what happens to a suspended workflow is host-specific, and is not. To implement this functionality using , create a custom that has this behavior.
+
+
+
+## Examples
+ The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet1":::
+
]]>
@@ -3248,11 +3248,11 @@ The following example calls
Persists a workflow instance to an instance store.
- used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
-
+ used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+
]]>
@@ -3276,19 +3276,19 @@ The following example calls
Persists a workflow instance to an instance store.
- is thrown.
-
- If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+ is thrown.
+
+ If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
## Examples
-The following example calls to persist a workflow instance before the workflow is started.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet34":::
-
+The following example calls to persist a workflow instance before the workflow is started.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet34":::
+
]]>
@@ -3315,17 +3315,17 @@ The following example calls The interval in which the persist operation must complete before the operation is canceled and a is thrown.
Persists a workflow instance to an instance store using the specified time-out interval.
- used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+ used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
## Examples
-The following example calls to persist a workflow instance before the workflow is started.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet34":::
-
+The following example calls to persist a workflow instance before the workflow is started.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet34":::
+
]]>
@@ -3355,18 +3355,18 @@ The following example calls Gets or sets the delegate that is invoked when the current workflow instance is idle and can be persisted.
The delegate that is invoked when the current workflow instance is idle and can be persisted.
- and are invoked, in that order. The handler returns one of the enumeration values of , , or .
-
-
-
-## Examples
- The following example handles the handler and instructs the runtime to persist and unload the workflow.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet26":::
-
+ and are invoked, in that order. The handler returns one of the enumeration values of , , or .
+
+
+
+## Examples
+ The following example handles the handler and instructs the runtime to persist and unload the workflow.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet26":::
+
]]>
@@ -3405,20 +3405,20 @@ The following example calls Initiates an operation to resume the specified bookmark, using the specified value. The bookmark to be resumed is previously created by an activity within the workflow instance.
The result of the bookmark resumption operation.
- . The workflow is started, and once the is created and the workflow goes idle, the user's input is gathered and the bookmark is resumed.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet24":::
-
+ . The workflow is started, and once the is created and the workflow goes idle, the user's input is gathered and the bookmark is resumed.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet24":::
+
]]>
@@ -3448,20 +3448,20 @@ The following example calls Initiates an operation to resume the bookmark with the specified name, using the specified value. The bookmark to be resumed is previously created by an activity within the workflow instance.
The result of the bookmark resumption operation.
- . The workflow is started, and once the is created and the workflow goes idle, the user's input is gathered and the bookmark is resumed.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet22":::
-
+ . The workflow is started, and once the is created and the workflow goes idle, the user's input is gathered and the bookmark is resumed.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet22":::
+
]]>
@@ -3493,20 +3493,20 @@ The following example calls Initiates an operation to resume the specified bookmark, using the specified value and time-out interval. The bookmark to be resumed is previously created by an activity within the workflow instance.
The result of the bookmark resumption operation.
- . The workflow is started, and once the is created and the workflow goes idle, the user's input is gathered and the bookmark is resumed.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet25":::
-
+ . The workflow is started, and once the is created and the workflow goes idle, the user's input is gathered and the bookmark is resumed.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet25":::
+
]]>
@@ -3538,20 +3538,20 @@ The following example calls Initiates an operation to resume the bookmark with the specified name, using the specified value and time-out interval. The bookmark to be resumed is previously created by an activity within the workflow instance.
The result of the bookmark resumption operation.
- . The workflow is started, and once the is created and the workflow goes idle, the user's input is gathered and the bookmark is resumed.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet22":::
-
+ . The workflow is started, and once the is created and the workflow goes idle, the user's input is gathered and the bookmark is resumed.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet15":::
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet22":::
+
]]>
@@ -3564,11 +3564,11 @@ The following example calls
Begins or resumes the execution of a workflow instance.
-
@@ -3592,29 +3592,29 @@ The following example calls
Begins or resumes the execution of a workflow instance.
- is thrown.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . When the workflow is completed, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Idle.
-Ending the workflow.
-Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Completed
-Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Unloaded.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet9":::
-
+ is thrown.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . When the workflow is completed, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Idle.
+Ending the workflow.
+Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Completed
+Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Unloaded.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet9":::
+
]]>
@@ -3644,32 +3644,32 @@ Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Unloaded.
- Call this method to initiate execution of a newly created workflow instance.
-
+ Call this method to initiate execution of a newly created workflow instance.
+
The interval in which the run operation must complete before the operation is canceled and a is thrown.
Begins or resumes the execution of a workflow instance using the specified time-out interval.
- , this method will time out only if the workflow doesn't start in the specified amount of time, rather than needing to complete in the specified amount of time. The reason for this is that executes the workflow synchronously (blocking the host thread), while executes asynchronously, only blocking the host thread for the amount of time it takes the workflow to start.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . When the workflow is completed, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Idle.
-Ending the workflow.
-Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Completed
-Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Unloaded.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet9":::
-
+ , this method will time out only if the workflow doesn't start in the specified amount of time, rather than needing to complete in the specified amount of time. The reason for this is that executes the workflow synchronously (blocking the host thread), while executes asynchronously, only blocking the host thread for the amount of time it takes the workflow to start.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . When the workflow is completed, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Idle.
+Ending the workflow.
+Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Completed
+Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Unloaded.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet9":::
+
]]>
@@ -3726,29 +3726,29 @@ Workflow 593976e8-558d-4989-94d6-50a14b34fd7b Unloaded.
The reason for terminating the workflow instance.
Terminates a workflow instance using the specified exception.
- handle.
-
- By default, the operation must complete in 30 seconds or a is thrown.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is terminated, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow e6b33409-f010-49f1-82ce-56f8baabe5e5 Terminated.
-Exception: System.ApplicationException
-Terminating the workflow.
-Workflow e6b33409-f010-49f1-82ce-56f8baabe5e5 unloaded.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet16":::
-
+ handle.
+
+ By default, the operation must complete in 30 seconds or a is thrown.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is terminated, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow e6b33409-f010-49f1-82ce-56f8baabe5e5 Terminated.
+Exception: System.ApplicationException
+Terminating the workflow.
+Workflow e6b33409-f010-49f1-82ce-56f8baabe5e5 unloaded.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet16":::
+
]]>
@@ -3775,29 +3775,29 @@ Workflow e6b33409-f010-49f1-82ce-56f8baabe5e5 unloaded.
The reason for terminating the workflow instance.
Terminates a workflow instance using the specified error message.
- handle.
-
- By default, the operation must complete in 30 seconds or a is thrown.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is terminated, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow f87c6f91-4fe4-40b9-b7cb-4f1bd071bf84 Terminated.
-Exception: System.Activities.WorkflowApplicationTerminatedException
-Terminating the workflow.
-Workflow f87c6f91-4fe4-40b9-b7cb-4f1bd071bf84 unloaded.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet18":::
-
+ handle.
+
+ By default, the operation must complete in 30 seconds or a is thrown.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is terminated, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow f87c6f91-4fe4-40b9-b7cb-4f1bd071bf84 Terminated.
+Exception: System.Activities.WorkflowApplicationTerminatedException
+Terminating the workflow.
+Workflow f87c6f91-4fe4-40b9-b7cb-4f1bd071bf84 unloaded.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet18":::
+
]]>
@@ -3826,27 +3826,27 @@ Workflow f87c6f91-4fe4-40b9-b7cb-4f1bd071bf84 unloaded.
The interval in which the operation must complete before the operation is canceled and a is thrown.
Terminates a workflow instance using the specified exception and time-out interval.
- handle.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is terminated, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow de28efe5-9057-472b-8d95-899c249893c5 Terminated.
-Exception: System.ApplicationException
-Terminating the workflow.
-Workflow de28efe5-9057-472b-8d95-899c249893c5 unloaded.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet17":::
-
+ handle.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is terminated, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow de28efe5-9057-472b-8d95-899c249893c5 Terminated.
+Exception: System.ApplicationException
+Terminating the workflow.
+Workflow de28efe5-9057-472b-8d95-899c249893c5 unloaded.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet17":::
+
]]>
@@ -3875,27 +3875,27 @@ Workflow de28efe5-9057-472b-8d95-899c249893c5 unloaded.
The interval in which the operation must complete before the operation is canceled and a is thrown.
Terminates a workflow instance using the specified error message and time-out interval.
- handle.
-
-
-
-## Examples
- The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is terminated, the following output is displayed to the console.
-
-```Output
-Starting the workflow.
-Workflow 2897d2ef-377e-4224-ae93-5c19b38f487c Terminated.
-Exception: System.Activities.WorkflowApplicationTerminatedException
-Terminating the workflow.
-Workflow 2897d2ef-377e-4224-ae93-5c19b38f487c unloaded.
-
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet19":::
-
+ handle.
+
+
+
+## Examples
+ The following example hosts a workflow using . A instance is constructed using the specified workflow definition, the desired workflow lifecycle events are handled, and the workflow is invoked with a call to . After the workflow is started, is called. When the workflow is terminated, the following output is displayed to the console.
+
+```Output
+Starting the workflow.
+Workflow 2897d2ef-377e-4224-ae93-5c19b38f487c Terminated.
+Exception: System.Activities.WorkflowApplicationTerminatedException
+Terminating the workflow.
+Workflow 2897d2ef-377e-4224-ae93-5c19b38f487c unloaded.
+
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet19":::
+
]]>
@@ -3908,13 +3908,13 @@ Workflow 2897d2ef-377e-4224-ae93-5c19b38f487c unloaded.
Persists and unloads a workflow instance.
- is thrown.
-
- If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
-
+ is thrown.
+
+ If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+
]]>
@@ -3938,19 +3938,19 @@ Workflow 2897d2ef-377e-4224-ae93-5c19b38f487c unloaded.
Persists and unloads a workflow instance.
- is thrown.
-
- If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+ is thrown.
+
+ If the workflow instance was previously loaded from persistence, then the same used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
## Examples
-In this example, the workflow is idle and the host application is waiting for user input. If the user chooses to unload, is called. If successful, the workflow is persisted and unloaded from memory.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet20":::
-
+In this example, the workflow is idle and the host application is waiting for user input. If the user chooses to unload, is called. If successful, the workflow is persisted and unloaded from memory.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet20":::
+
]]>
@@ -3977,17 +3977,17 @@ In this example, the workflow is idle and the host application is waiting for us
The interval in which the unload operation must complete before the operation is canceled and a is thrown.
Persists and unloads a workflow instance using the specified time-out interval.
- used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
+ used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an must be configured before calling this method or else an is thrown when this method is called.
## Examples
-In this example, the workflow is idle and the host application is waiting for user input. If the user chooses to unload, is called. If successful, the workflow is persisted and unloaded from memory.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet20":::
-
+In this example, the workflow is idle and the host application is waiting for user input. If the user chooses to unload, is called. If successful, the workflow is persisted and unloaded from memory.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet20":::
+
]]>
@@ -4017,13 +4017,13 @@ In this example, the workflow is idle and the host application is waiting for us
Gets or sets the that is invoked when the current workflow unloads.
An action that is invoked when a workflow instance is unloaded.
- passed into the handler of a instance and displays the of the workflow that was unloaded.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet3":::
-
+ passed into the handler of a instance and displays the of the workflow that was unloaded.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet3":::
+
]]>
diff --git a/xml/System.Activities/WorkflowApplicationAbortedEventArgs.xml b/xml/System.Activities/WorkflowApplicationAbortedEventArgs.xml
index 922043e5e21..5d076cd4be8 100644
--- a/xml/System.Activities/WorkflowApplicationAbortedEventArgs.xml
+++ b/xml/System.Activities/WorkflowApplicationAbortedEventArgs.xml
@@ -16,18 +16,18 @@
Provides data about an aborted workflow instance.
- is aborted, the handler is invoked and the handler is not invoked.
-
-
-
-## Examples
- The following code example inspects the passed into the handler of a instance and displays information about why workflow was aborted.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet5":::
-
+ is aborted, the handler is invoked and the handler is not invoked.
+
+
+
+## Examples
+ The following code example inspects the passed into the handler of a instance and displays information about why workflow was aborted.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet5":::
+
]]>
@@ -57,18 +57,18 @@
Gets the exception that provides information about why the workflow instance was aborted.
The exception that provides information about why the workflow instance was aborted.
- is aborted, the handler is invoked and the handler is not invoked.
-
-
-
-## Examples
- The following code example inspects the passed into the handler of a instance and displays information about why workflow was aborted.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet5":::
-
+ is aborted, the handler is invoked and the handler is not invoked.
+
+
+
+## Examples
+ The following code example inspects the passed into the handler of a instance and displays information about why workflow was aborted.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet5":::
+
]]>
diff --git a/xml/System.Activities/WorkflowApplicationCompletedEventArgs.xml b/xml/System.Activities/WorkflowApplicationCompletedEventArgs.xml
index 6d17b22672b..645c70edb9e 100644
--- a/xml/System.Activities/WorkflowApplicationCompletedEventArgs.xml
+++ b/xml/System.Activities/WorkflowApplicationCompletedEventArgs.xml
@@ -16,13 +16,13 @@
Provides information about a workflow instance that has completed its execution.
- passed into the handler of a instance and displays information about how the workflow completed.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet4":::
-
+ passed into the handler of a instance and displays information about how the workflow completed.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet4":::
+
]]>
@@ -52,13 +52,13 @@
Gets the completion state of the workflow instance, which indicates whether the workflow instance completed successfully, was canceled, or faulted.
The completion state of the workflow instance, which indicates whether the workflow instance completed successfully, was canceled, or faulted.
- passed into the handler of a instance and displays information about how the workflow completed.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet4":::
-
+ passed into the handler of a instance and displays information about how the workflow completed.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet4":::
+
]]>
@@ -82,13 +82,13 @@
Gets a dictionary that contains the values of s of the workflow instance's root activity, keyed by argument name.
A dictionary that contains the values of s of the workflow instance's root activity, keyed by argument name.
- passed into the handler of a instance and displays information about how the workflow completed.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet4":::
-
+ passed into the handler of a instance and displays information about how the workflow completed.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet4":::
+
]]>
@@ -118,13 +118,13 @@
Gets the exception associated with the termination of the workflow instance.
The exception associated with the termination of the workflow instance.
- passed into the handler of a instance and displays information about how the workflow completed.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet4":::
-
+ passed into the handler of a instance and displays information about how the workflow completed.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet4":::
+
]]>
diff --git a/xml/System.Activities/WorkflowApplicationEventArgs.xml b/xml/System.Activities/WorkflowApplicationEventArgs.xml
index 35379a6f600..4176cbc9ab4 100644
--- a/xml/System.Activities/WorkflowApplicationEventArgs.xml
+++ b/xml/System.Activities/WorkflowApplicationEventArgs.xml
@@ -16,18 +16,18 @@
A base class for events associated with a .
- is also used in the handler of a instance.
-
-
-
-## Examples
- The following code example inspects the passed into the handler of a instance and displays the of the workflow that was unloaded.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet3":::
-
+ is also used in the handler of a instance.
+
+
+
+## Examples
+ The following code example inspects the passed into the handler of a instance and displays the of the workflow that was unloaded.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet3":::
+
]]>
@@ -81,13 +81,13 @@
The unique identifier of the workflow instance.
A unique identifier.
- passed into the handler of a instance and displays the of the workflow that was unloaded.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet3":::
-
+ passed into the handler of a instance and displays the of the workflow that was unloaded.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet3":::
+
]]>
diff --git a/xml/System.Activities/WorkflowApplicationIdleEventArgs.xml b/xml/System.Activities/WorkflowApplicationIdleEventArgs.xml
index 25077b3a2d2..bb2704efa32 100644
--- a/xml/System.Activities/WorkflowApplicationIdleEventArgs.xml
+++ b/xml/System.Activities/WorkflowApplicationIdleEventArgs.xml
@@ -16,17 +16,17 @@
Holds information about the workflow instance that has become idle.
- passed into the handler of a instance. In this example the workflow going idle has one with a name of `EnterGuess`, owned by an activity named `ReadInt`. This code example is based off of [How to: Run a Workflow](/dotnet/framework/windows-workflow-foundation/how-to-run-a-workflow), which is part of the [Getting Started Tutorial [.NET Framework 4.5]](/dotnet/framework/windows-workflow-foundation/getting-started-tutorial). If the handler in that step is modified to contain the code from this example, the following output is displayed.
-
-```Output
-BookmarkName: EnterGuess - OwnerDisplayName: ReadInt
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet2":::
-
+ passed into the handler of a instance. In this example the workflow going idle has one with a name of `EnterGuess`, owned by an activity named `ReadInt`. This code example is based off of [How to: Run a Workflow](/dotnet/framework/windows-workflow-foundation/how-to-run-a-workflow), which is part of the [Getting Started Tutorial [.NET Framework 4.5]](/dotnet/framework/windows-workflow-foundation/getting-started-tutorial). If the handler in that step is modified to contain the code from this example, the following output is displayed.
+
+```Output
+BookmarkName: EnterGuess - OwnerDisplayName: ReadInt
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet2":::
+
]]>
@@ -50,17 +50,17 @@ BookmarkName: EnterGuess - OwnerDisplayName: ReadInt
Gets the read-only collection of bookmarks for the workflow instance.
A read-only collection of bookmarks.
- passed into the handler of a instance. In this example the workflow going idle has one with a name of `EnterGuess`, owned by an activity named `ReadInt`. This code example is based off of [How to: Run a Workflow](/dotnet/framework/windows-workflow-foundation/how-to-run-a-workflow), which is part of the [Getting Started Tutorial [.NET Framework 4.5]](/dotnet/framework/windows-workflow-foundation/getting-started-tutorial). If the handler in that step is modified to contain the code from this example, the following output is displayed.
-
-```Output
-BookmarkName: EnterGuess - OwnerDisplayName: ReadInt
-```
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet2":::
-
+ passed into the handler of a instance. In this example the workflow going idle has one with a name of `EnterGuess`, owned by an activity named `ReadInt`. This code example is based off of [How to: Run a Workflow](/dotnet/framework/windows-workflow-foundation/how-to-run-a-workflow), which is part of the [Getting Started Tutorial [.NET Framework 4.5]](/dotnet/framework/windows-workflow-foundation/getting-started-tutorial). If the handler in that step is modified to contain the code from this example, the following output is displayed.
+
+```Output
+BookmarkName: EnterGuess - OwnerDisplayName: ReadInt
+```
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet2":::
+
]]>
diff --git a/xml/System.Activities/WorkflowApplicationUnhandledExceptionEventArgs.xml b/xml/System.Activities/WorkflowApplicationUnhandledExceptionEventArgs.xml
index f08f9b838de..4d2bd3996ac 100644
--- a/xml/System.Activities/WorkflowApplicationUnhandledExceptionEventArgs.xml
+++ b/xml/System.Activities/WorkflowApplicationUnhandledExceptionEventArgs.xml
@@ -16,18 +16,18 @@
Provides information about an unhandled exception that occurred in a workflow instance.
- handler is present, it can override this default behavior. This handler gives the workflow host author an opportunity to provide the appropriate handling, such as custom logging, aborting the workflow, canceling the workflow, or terminating the workflow.
-
-
-
-## Examples
- The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet1":::
-
+ handler is present, it can override this default behavior. This handler gives the workflow host author an opportunity to provide the appropriate handling, such as custom logging, aborting the workflow, canceling the workflow, or terminating the workflow.
+
+
+
+## Examples
+ The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet1":::
+
]]>
@@ -57,18 +57,18 @@
Gets the activity that is the source of the unhandled exception.
An activity.
- handler is present, it can override this default behavior. This handler gives the workflow host author an opportunity to provide the appropriate handling, such as custom logging, aborting the workflow, canceling the workflow, or terminating the workflow.
-
-
-
-## Examples
- The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet1":::
-
+ handler is present, it can override this default behavior. This handler gives the workflow host author an opportunity to provide the appropriate handling, such as custom logging, aborting the workflow, canceling the workflow, or terminating the workflow.
+
+
+
+## Examples
+ The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet1":::
+
]]>
@@ -98,18 +98,18 @@
Gets the unique identifier of the activity instance that is the source of the unhandled exception.
An identifier of the activity instance that is the source of the unhandled exception.
- handler is present, it can override this default behavior. This handler gives the workflow host author an opportunity to provide the appropriate handling, such as custom logging, aborting the workflow, canceling the workflow, or terminating the workflow.
-
-
-
-## Examples
- The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet1":::
-
+ handler is present, it can override this default behavior. This handler gives the workflow host author an opportunity to provide the appropriate handling, such as custom logging, aborting the workflow, canceling the workflow, or terminating the workflow.
+
+
+
+## Examples
+ The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet1":::
+
]]>
@@ -139,18 +139,18 @@
Gets the that was unhandled by the workflow instance.
The that was unhandled by the workflow instance.
- handler is present, it can override this default behavior. This handler gives the workflow host author an opportunity to provide the appropriate handling, such as custom logging, aborting the workflow, canceling the workflow, or terminating the workflow.
-
-
-
-## Examples
- The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
-
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet1":::
-
+ handler is present, it can override this default behavior. This handler gives the workflow host author an opportunity to provide the appropriate handling, such as custom logging, aborting the workflow, canceling the workflow, or terminating the workflow.
+
+
+
+## Examples
+ The following example invokes a workflow that throws an exception. The exception is unhandled by the workflow and the handler is invoked. The are inspected to provide information about the exception, and the workflow is terminated.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs" id="Snippet1":::
+
]]>
diff --git a/xml/System.Activities/WorkflowInspectionServices.xml b/xml/System.Activities/WorkflowInspectionServices.xml
index c0cba4502d4..6245e1cbfbf 100644
--- a/xml/System.Activities/WorkflowInspectionServices.xml
+++ b/xml/System.Activities/WorkflowInspectionServices.xml
@@ -143,13 +143,13 @@
Returns an that represents all activities associated with the input activity.
An enumeration that represents all activities associated with the input activity.
- is thrown. The activity tree must remain unmodified and must not be called while the tree is being enumerated or else an is thrown when is called.
-
- Calling this method causes a full cache metadata to occur. If you make changes to the workflow after calling this method, you must call the method after making the changes in order to re-cache the metadata.
-
+ is thrown. The activity tree must remain unmodified and must not be called while the tree is being enumerated or else an is thrown when is called.
+
+ Calling this method causes a full cache metadata to occur. If you make changes to the workflow after calling this method, you must call the method after making the changes in order to re-cache the metadata.
+
]]>
diff --git a/xml/System.Activities/WorkflowInvoker.xml b/xml/System.Activities/WorkflowInvoker.xml
index c2f2ab7afa9..f4b809e05d3 100644
--- a/xml/System.Activities/WorkflowInvoker.xml
+++ b/xml/System.Activities/WorkflowInvoker.xml
@@ -23,7 +23,7 @@
does not allow instance control such as persisting, unloading, or resuming bookmarks. If instance control is desired, use instead.
- To execute workflows synchronously with no instance control, call the method. To execute a workflow asynchronously with no instance control, use the and method pairs, or the method.
+ To execute workflows synchronously with no instance control, call the method. To execute a workflow asynchronously with no instance control, use the and method pairs, or the method.
@@ -116,14 +116,14 @@
from the `callback` method. If is called before the workflow completes, it blocks until the workflow completes. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
+ To be notified when the workflow is complete and retrieve the output parameters of the workflow, call from the `callback` method. If is called before the workflow completes, it blocks until the workflow completes. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
This method invokes a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
## Examples
- The following example invokes a workflow consisting of a `LongRunningDiceRoll` activity. The `LongRunningDiceRoll` activity has two output arguments that represent the results of the dice roll operation. These are retrieved by calling . When the call to returns, each output argument is returned in the outputs dictionary, keyed by argument name.
+ The following example invokes a workflow consisting of a `LongRunningDiceRoll` activity. The `LongRunningDiceRoll` activity has two output arguments that represent the results of the dice roll operation. These are retrieved by calling . When the call to returns, each output argument is returned in the outputs dictionary, keyed by argument name.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet131":::
@@ -163,14 +163,14 @@
from the `callback` method. If is called before the workflow completes, it blocks until the workflow completes. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
+ To be notified when the workflow is complete and retrieve the output parameters of the workflow, call from the `callback` method. If is called before the workflow completes, it blocks until the workflow completes. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
This method invokes a workflow asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
## Examples
- The following example invokes a workflow consisting of a `LongRunningDiceRoll` activity. The `LongRunningDiceRoll` activity has two output arguments that represent the results of the dice roll operation. These are retrieved by calling . When the call to returns, each output argument is returned in the outputs dictionary, keyed by argument name.
+ The following example invokes a workflow consisting of a `LongRunningDiceRoll` activity. The `LongRunningDiceRoll` activity has two output arguments that represent the results of the dice roll operation. These are retrieved by calling . When the call to returns, each output argument is returned in the outputs dictionary, keyed by argument name.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet131":::
@@ -210,7 +210,7 @@
from the `callback` method. If is called before the workflow completes, it blocks until the workflow completes. If the workflow does not complete within the specified time-out interval the workflow is aborted and a is thrown when the method is called.
+ To be notified when the workflow is complete and retrieve the output parameters of the workflow, call from the `callback` method. If is called before the workflow completes, it blocks until the workflow completes. If the workflow does not complete within the specified time-out interval the workflow is aborted and a is thrown when the method is called.
> [!NOTE]
> The is only thrown if the time-out interval elapses and the workflow becomes idle during execution. A workflow that takes longer than the specified time-out interval to complete completes successfully if the workflow does not become idle.
@@ -220,7 +220,7 @@
## Examples
- The following example invokes a workflow consisting of a `LongRunningDiceRoll` activity. The `LongRunningDiceRoll` activity has two output arguments that represent the results of the dice roll operation. These are retrieved by calling . When the call to returns, each output argument is returned in the outputs dictionary, keyed by argument name.
+ The following example invokes a workflow consisting of a `LongRunningDiceRoll` activity. The `LongRunningDiceRoll` activity has two output arguments that represent the results of the dice roll operation. These are retrieved by calling . When the call to returns, each output argument is returned in the outputs dictionary, keyed by argument name.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet131":::
@@ -262,7 +262,7 @@
from the `callback` method. If is called before the workflow completes, it blocks until the workflow completes. If the workflow does not complete within the specified time-out interval the workflow is aborted and a is thrown when is called.
+ To be notified when the workflow is complete and retrieve the output parameters of the workflow, call from the `callback` method. If is called before the workflow completes, it blocks until the workflow completes. If the workflow does not complete within the specified time-out interval the workflow is aborted and a is thrown when is called.
> [!NOTE]
> The is only thrown if the time-out interval elapses and the workflow becomes idle during execution. A workflow that takes longer than the specified time-out interval to complete completes successfully if the workflow does not become idle.
@@ -272,7 +272,7 @@
## Examples
- The following example invokes a workflow consisting of a `LongRunningDiceRoll` activity. The `LongRunningDiceRoll` activity has two output arguments that represent the results of the dice roll operation. These are retrieved by calling . When the call to returns, each output argument is returned in the outputs dictionary, keyed by argument name.
+ The following example invokes a workflow consisting of a `LongRunningDiceRoll` activity. The `LongRunningDiceRoll` activity has two output arguments that represent the results of the dice roll operation. These are retrieved by calling . When the call to returns, each output argument is returned in the outputs dictionary, keyed by argument name.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet131":::
@@ -307,7 +307,7 @@
overloads that takes a `userState` parameter can be canceled.
+ Only a workflow invoked by one of the overloads that takes a `userState` parameter can be canceled.
If the cancellation succeeds, the property of the passed to the handler is set to `true`; otherwise, it is set to `false`.
@@ -350,14 +350,14 @@
from the `callback` method specified by . If is called before the workflow completes, it blocks until the workflow completes.
+ To be notified when the workflow is complete and retrieve the output parameters of the workflow, call from the `callback` method specified by . If is called before the workflow completes, it blocks until the workflow completes.
This method returns the result of a workflow invoked asynchronously using the asynchronous design pattern. For more information, see [Asynchronous Programming Overview](/dotnet/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm).
## Examples
- The following example invokes a workflow consisting of a `LongRunningDiceRoll` activity. The `LongRunningDiceRoll` activity has two output arguments that represent the results of the dice roll operation. These are retrieved by calling . When the call to returns, each output argument is returned in the outputs dictionary, keyed by argument name.
+ The following example invokes a workflow consisting of a `LongRunningDiceRoll` activity. The `LongRunningDiceRoll` activity has two output arguments that represent the results of the dice roll operation. These are retrieved by calling . When the call to returns, each output argument is returned in the outputs dictionary, keyed by argument name.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet131":::
@@ -394,7 +394,7 @@
## Examples
- The following example registers a custom with the collection of a instance. This code example is part of the [Custom Tracking](/dotnet/framework/windows-workflow-foundation/samples/custom-tracking) sample.
+ The following example registers a custom with the collection of a instance. This code example is part of the [Custom Tracking](/dotnet/framework/windows-workflow-foundation/samples/custom-tracking) sample.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet40":::
@@ -413,7 +413,7 @@
overloads that take a .
+ This method blocks until the workflow has completed, including idle time. All workflow execution is guaranteed to execute on the invoking thread. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
]]>
@@ -442,7 +442,7 @@
overloads that take a .
+ This method blocks until the workflow has completed, including idle time. All workflow execution is guaranteed to execute on the invoking thread. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
@@ -487,7 +487,7 @@
overloads that take a .
+ This method blocks until the workflow has completed, including idle time. All workflow execution is guaranteed to execute on the invoking thread. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
@@ -532,7 +532,7 @@
overloads that take a .
+ This method blocks until the workflow has completed, including idle time. All workflow execution is guaranteed to execute on the invoking thread. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
@@ -543,7 +543,7 @@
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet22":::
- If the workflow derives from , such as `CodeActivity` or `Activity`, and there are output arguments in addition to the well-defined output argument, a non-generic overload of `Invoke`, such as this one, must be used in order to retrieve the additional arguments. To do this, the workflow definition passed into the `WorkflowInvoker` constructor must be of type . In this example the `Divide` activity derives from `CodeActivity`, but is declared as so that this overload of `Invoke`, which returns a dictionary of arguments instead of a single return value, is used.
+ If the workflow derives from , such as `CodeActivity` or `Activity`, and there are output arguments in addition to the well-defined output argument, a non-generic overload of `Invoke`, such as this one, must be used in order to retrieve the additional arguments. To do this, the workflow definition passed into the `WorkflowInvoker` constructor must be of type . In this example the `Divide` activity derives from `CodeActivity`, but is declared as so that this overload of `Invoke`, which returns a dictionary of arguments instead of a single return value, is used.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet121":::
@@ -587,7 +587,7 @@
## Examples
- The following example invokes a workflow that contains two activities and a activity configured with a of one minute. This workflow is invoked twice; the first time with a time-out interval of two minutes, and the second time with a time-out interval of 30 seconds. The first workflow completes successfully, but the second one does not and a is thrown and the following message is displayed.
+ The following example invokes a workflow that contains two activities and a activity configured with a of one minute. This workflow is invoked twice; the first time with a time-out interval of two minutes, and the second time with a time-out interval of 30 seconds. The first workflow completes successfully, but the second one does not and a is thrown and the following message is displayed.
```Output
The operation did not complete within the allotted timeout of 00:00:30.
@@ -596,7 +596,7 @@ The time allotted to this operation may have been a portion of a longer timeout.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet51":::
- For an example of using `Invoke` with output arguments, see the overload of with the same parameters as this overload without the time-out interval.
+ For an example of using `Invoke` with output arguments, see the overload of with the same parameters as this overload without the time-out interval.
]]>
@@ -630,7 +630,7 @@ The time allotted to this operation may have been a portion of a longer timeout.
overloads that take a .
+ This method blocks until the workflow has completed, including idle time. All workflow execution is guaranteed to execute on the invoking thread. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
@@ -641,7 +641,7 @@ The time allotted to this operation may have been a portion of a longer timeout.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet20":::
- If the workflow derives from , such as `CodeActivity` or `Activity`, and there are output arguments in addition to the well-defined output argument, a non-generic overload of `Invoke`, such as this one, must be used in order to retrieve the additional arguments. To do this, the workflow definition passed into `Invoke` must be of type . In this example the `Divide` activity derives from `CodeActivity`, but is declared as so that this overload of `Invoke`, which returns a dictionary of arguments instead of a single return value, is used.
+ If the workflow derives from , such as `CodeActivity` or `Activity`, and there are output arguments in addition to the well-defined output argument, a non-generic overload of `Invoke`, such as this one, must be used in order to retrieve the additional arguments. To do this, the workflow definition passed into `Invoke` must be of type . In this example the `Divide` activity derives from `CodeActivity`, but is declared as so that this overload of `Invoke`, which returns a dictionary of arguments instead of a single return value, is used.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet121":::
@@ -693,11 +693,11 @@ The time allotted to this operation may have been a portion of a longer timeout.
## Examples
- The following example invokes a workflow that contains two activities and a activity configured with a of one minute. This workflow is invoked twice; the first time with a time-out interval of two minutes, and the second time with a time-out interval of 30 seconds. The first workflow completes successfully, but the second one does not and a is thrown.
+ The following example invokes a workflow that contains two activities and a activity configured with a of one minute. This workflow is invoked twice; the first time with a time-out interval of two minutes, and the second time with a time-out interval of 30 seconds. The first workflow completes successfully, but the second one does not and a is thrown.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet50":::
- For an example of using `Invoke` with output arguments, see the overload of with the same parameters as this overload without the time-out interval.
+ For an example of using `Invoke` with output arguments, see the overload of with the same parameters as this overload without the time-out interval.
]]>
@@ -739,7 +739,7 @@ The time allotted to this operation may have been a portion of a longer timeout.
## Examples
- The following example invokes a workflow that contains two activities and a activity configured with a of one minute. This workflow is invoked twice; the first time with a time-out interval of two minutes, and the second time with a time-out interval of 30 seconds. The first workflow completes successfully, but the second one does not and a is thrown and the following message is displayed.
+ The following example invokes a workflow that contains two activities and a activity configured with a of one minute. This workflow is invoked twice; the first time with a time-out interval of two minutes, and the second time with a time-out interval of 30 seconds. The first workflow completes successfully, but the second one does not and a is thrown and the following message is displayed.
```Output
The operation did not complete within the allotted timeout of 00:00:30.
@@ -748,7 +748,7 @@ The time allotted to this operation may have been a portion of a longer timeout.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet51":::
- For an example of using `Invoke` with input and output arguments, see the overload of with the same parameters as this overload without the time-out interval.
+ For an example of using `Invoke` with input and output arguments, see the overload of with the same parameters as this overload without the time-out interval.
]]>
@@ -798,11 +798,11 @@ The time allotted to this operation may have been a portion of a longer timeout.
## Examples
- The following example invokes a workflow that contains two activities and a activity configured with a of one minute. This workflow is invoked twice; the first time with a time-out interval of two minutes, and the second time with a time-out interval of 30 seconds. The first workflow completes successfully, but the second one does not and a is thrown.
+ The following example invokes a workflow that contains two activities and a activity configured with a of one minute. This workflow is invoked twice; the first time with a time-out interval of two minutes, and the second time with a time-out interval of 30 seconds. The first workflow completes successfully, but the second one does not and a is thrown.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet50":::
- For an example of using `Invoke` with input and output arguments, see the overload of with the same parameters as this overload without the time-out interval.
+ For an example of using `Invoke` with input and output arguments, see the overload of with the same parameters as this overload without the time-out interval.
]]>
@@ -844,11 +844,11 @@ The time allotted to this operation may have been a portion of a longer timeout.
overloads that take a .
+ This method blocks until the workflow has completed, including idle time. All workflow execution is guaranteed to execute on the invoking thread. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
## Examples
-The following example invokes a workflow consisting of a single `Add` activity that has two input arguments and since it derives from `CodeActivity` it has one well-defined output argument. When the workflow is invoked, the `arguments` dictionary is passed that contains the values for each input argument, keyed by argument name. When the call to `Invoke` returns, the value of the output argument is returned.
+The following example invokes a workflow consisting of a single `Add` activity that has two input arguments and since it derives from `CodeActivity` it has one well-defined output argument. When the workflow is invoked, the `arguments` dictionary is passed that contains the values for each input argument, keyed by argument name. When the call to `Invoke` returns, the value of the output argument is returned.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet110":::
@@ -890,14 +890,14 @@ The following example invokes a workflow consisting of a single `Add` activity t
overloads that take a .
+ This method blocks until the workflow has completed, including idle time. All workflow execution is guaranteed to execute on the invoking thread. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
> [!NOTE]
> The is only thrown if the time-out interval elapses and the workflow becomes idle during execution. A workflow that takes longer than the specified time-out interval to complete, completes successfully if the workflow does not become idle.
## Examples
-The following example invokes a workflow consisting of a single `Add` activity that has two input arguments and since it derives from `CodeActivity` it has one well-defined output argument. When the workflow is invoked, the `arguments` dictionary is passed that contains the values for each input argument, keyed by argument name. When the call to `Invoke` returns, the value of the output argument is returned.
+The following example invokes a workflow consisting of a single `Add` activity that has two input arguments and since it derives from `CodeActivity` it has one well-defined output argument. When the workflow is invoked, the `arguments` dictionary is passed that contains the values for each input argument, keyed by argument name. When the call to `Invoke` returns, the value of the output argument is returned.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet110":::
@@ -948,7 +948,7 @@ The following example invokes a workflow consisting of a single `Add` activity t
## Examples
-The following example invokes a workflow consisting of a single `Add` activity that has two input arguments and since it derives from `CodeActivity` it has one well-defined output argument. When the workflow is invoked, the `arguments` dictionary is passed that contains the values for each input argument, keyed by argument name. When the call to `Invoke` returns, the value of the output argument is returned.
+The following example invokes a workflow consisting of a single `Add` activity that has two input arguments and since it derives from `CodeActivity` it has one well-defined output argument. When the workflow is invoked, the `arguments` dictionary is passed that contains the values for each input argument, keyed by argument name. When the call to `Invoke` returns, the value of the output argument is returned.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet110":::
@@ -1001,7 +1001,7 @@ The following example invokes a workflow consisting of a single `Add` activity t
## Examples
-The following example invokes a workflow consisting of a single `Add` activity that has two input arguments and since it derives from `CodeActivity` it has one well-defined output argument. When the workflow is invoked, the `arguments` dictionary is passed that contains the values for each input argument, keyed by argument name. When the call to `Invoke` returns, the value of the output argument is returned.
+The following example invokes a workflow consisting of a single `Add` activity that has two input arguments and since it derives from `CodeActivity` it has one well-defined output argument. When the workflow is invoked, the `arguments` dictionary is passed that contains the values for each input argument, keyed by argument name. When the call to `Invoke` returns, the value of the output argument is returned.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet110":::
@@ -1022,7 +1022,7 @@ The following example invokes a workflow consisting of a single `Add` activity t
. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
+ To be notified when the workflow is complete, handle . To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
This method invokes a workflow asynchronously using the event-based asynchronous design pattern. For more information, see [Event-based Asynchronous Pattern Overview](/dotnet/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview).
@@ -1052,7 +1052,7 @@ The following example invokes a workflow consisting of a single `Add` activity t
. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
+ To be notified when the workflow is complete, handle . To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
This method invokes a workflow asynchronously using the event-based asynchronous design pattern. For more information, see [Event-based Asynchronous Pattern Overview](/dotnet/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview).
@@ -1100,7 +1100,7 @@ The following example invokes a workflow consisting of a single `Add` activity t
. To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
+ To be notified when the workflow is complete, handle . To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
This method invokes a workflow asynchronously using the event-based asynchronous design pattern. For more information, see [Event-based Asynchronous Pattern Overview](/dotnet/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview).
@@ -1142,9 +1142,9 @@ The following example invokes a workflow consisting of a single `Add` activity t
operations for the current activity. If the `userState` parameter is not unique, an is thrown. `userState` is used to identify the workflow in , and to cancel the workflow using .
+ The `userState` parameter must be unique across all currently running operations for the current activity. If the `userState` parameter is not unique, an is thrown. `userState` is used to identify the workflow in , and to cancel the workflow using .
- To be notified when the workflow is complete, handle . To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
+ To be notified when the workflow is complete, handle . To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
This method invokes a workflow asynchronously using the event-based asynchronous design pattern. For more information, see [Event-based Asynchronous Pattern Overview](/dotnet/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview).
@@ -1239,9 +1239,9 @@ The following example invokes a workflow consisting of a single `Add` activity t
operations for the current activity. If `userState` is not unique, an is thrown. `userState` is used to identify the workflow in , and to cancel the workflow using .
+ The `userState` parameter must be unique across all currently running operations for the current activity. If `userState` is not unique, an is thrown. `userState` is used to identify the workflow in , and to cancel the workflow using .
- To be notified when the workflow is complete, handle . To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
+ To be notified when the workflow is complete, handle . To configure a time-out interval in which the workflow must complete, use one of the overloads that take a .
This method invokes a workflow asynchronously using the event-based asynchronous design pattern. For more information, see [Event-based Asynchronous Pattern Overview](/dotnet/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview).
@@ -1338,7 +1338,7 @@ This method stores in the task it returns all non-usage exceptions that the meth
operations for the current activity. If `userState` is not unique, an is thrown. `userState` is used to identify the workflow in , and to cancel the workflow using .
+ The `userState` parameter must be unique across all currently running operations for the current activity. If `userState` is not unique, an is thrown. `userState` is used to identify the workflow in , and to cancel the workflow using .
To be notified when the workflow is complete, handle . If the workflow does not complete within the specified time-out interval the workflow is aborted and a is thrown.
@@ -1389,7 +1389,7 @@ This method stores in the task it returns all non-usage exceptions that the meth
operations for the current activity. If `userState` is not unique, an is thrown. `userState` is used to identify the workflow in