CreateWorkflowQueue Method

WorkflowQueuingService.CreateWorkflowQueue Method (IComparable, Boolean)


Creates a WorkflowQueue by using the specified name and transactional scope.

Namespace:   System.Workflow.Runtime
Assembly:  System.Workflow.Runtime (in System.Workflow.Runtime.dll)

public WorkflowQueue CreateWorkflowQueue(
	IComparable queueName,
	bool transactional


Type: System.IComparable

The name of the queue.

Type: System.Boolean

A value that specifies whether the WorkflowQueue is visible outside the scope of the current transaction.

Exception Condition

queueName is a null reference (Nothing in Visual Basic).


A WorkflowQueue with the name specified by queueName already exists.

A WorkflowQueue is created with the specified queueName. If transactional is true, the WorkflowQueue is only visible inside the current transaction.

The following code example demonstrates a method, named CreateQueue, that initializes a WorkflowQueuingService object by calling the ActivityExecutionContext.GetService<T> method. The code then uses the Exists method to determine if a WorkflowQueue with a specified name exists. If it does not exist, the code calls the CreateWorkflowQueue method; if it does the code calls the GetWorkflowQueue method.

This code example is part of the File Watcher Activity SDK Sample from the FileSystemEvent.cs file. For more information, see 5442b63a-bdad-43d0-b7cf-f0b5d8b56a99.

private WorkflowQueue CreateQueue(ActivityExecutionContext context)
    WorkflowQueuingService qService = context.GetService<WorkflowQueuingService>();

    if (!qService.Exists(this.QueueName))
        qService.CreateWorkflowQueue(this.QueueName, true);

    return qService.GetWorkflowQueue(this.QueueName);

.NET Framework
Available since 3.0
Return to top
© 2016 Microsoft