This documentation is archived and is not being maintained.

WorkflowQueuingService.CreateWorkflowQueue Method

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.


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 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 File System Watcher Activity.

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

Supported in: 4, 3.5, 3.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.